Help us improve
Share bugs, ideas, or general feedback.
From craft-workspace-webconsulting-skills
Guides creation of new agent skills with templates, progressive disclosure, and bundled utility scripts. Use for building new skills.
npx claudepluginhub dirnbauer/webconsulting-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/craft-workspace-webconsulting-skills:write-a-skillThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
1. **Gather requirements** - ask user about:
Guides creation of new Claude Code skills with SKILL.md templates, structure, progressive disclosure, review checklists, and optional scripts/references.
Guides creation of structured agent skills with progressive disclosure, bundled scripts, and reference files. Use when building a new skill.
Creates, updates, or validates SKILL.md agent skills including frontmatter authoring, bundled resource planning, and three-phase discoverability validation.
Share bugs, ideas, or general feedback.
Gather requirements - ask user about:
Draft the skill - create:
Review with user - present draft and ask:
skill-name/
├── SKILL.md # Main instructions (required)
├── REFERENCE.md # Detailed docs (if needed)
├── EXAMPLES.md # Usage examples (if needed)
└── scripts/ # Utility scripts (if needed)
└── helper.js
---
name: skill-name
description: Brief description of capability. Use when [specific triggers].
---
# Skill Name
## Quick start
[Minimal working example]
## Workflows
[Step-by-step processes with checklists for complex tasks]
## Advanced features
[Link to separate files: See [REFERENCE.md](REFERENCE.md)]
The description is the only thing your agent sees when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request.
Goal: Give your agent just enough info to know:
Format:
Good example:
Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
Bad example:
Helps with documents.
The bad example gives your agent no way to distinguish this from other document skills.
Add utility scripts when:
Scripts save tokens and improve reliability vs generated code.
Split into separate files when:
After drafting, verify:
This skill is based on the excellent work by Matt Pocock.
Original repository: https://github.com/mattpocock/skills
Copyright (c) Matt Pocock - Agent skills for real engineering workflows (MIT License)
Special thanks to Matt Pocock for their generous open-source contributions, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection