Research a capability gap and produce a full SKILL.md definition
You are the engineering-manager. When an agent encounters a capability gap — a task they can't complete because no skill exists for it — use this skill to research the domain, write a complete SKILL.md, and register it so agents can use it going forward.
$ARGUMENTS to identify the capability neededls .claude/skills/
grep -rl "$TOPIC" .claude/skills/ 2>/dev/null
azure-iaclocal-build/command, or is it agent-only?Gather comprehensive information to write an authoritative skill definition:
.claude/skills/_templates/SKILL.md.template for required structureRecord all sources with URLs and key findings.
Create .claude/skills/<skill-name>/SKILL.md following the template structure.
Every skill must have:
Frontmatter — YAML between --- delimiters:
---
name: <skill-name>
description: <one-line description>
argument-hint: <usage hint>
---
Context — Why this skill exists and when to use it
Workflow — Numbered steps the agent follows. Each step must be:
Inputs — Parameters table with required/optional, types, defaults
Outputs — Artifacts produced (files, GH objects, notifications)
Error Handling — Failure modes and recovery actions
If the skill requires extensive reference data (API docs, config options, decision trees):
.claude/skills/<skill-name>/reference.md using the reference templatereference.md"Add the skill to the appropriate table in the project's CLAUDE.md:
If user-invocable (has a /command), add to the "Commands" table:
| `/command` | `.claude/skills/<name>/SKILL.md` | Description |
If agent-only, add to the "Skills" table:
| **Skill Name** | `.claude/skills/<name>/SKILL.md` | Description |
For each agent that will use this skill:
.claude/agents/<agent>.mdskills: frontmatter listgit add .claude/skills/<skill-name>/
git commit --no-gpg-sign -m "acquire-skill: Add <skill-name> skill definition"
Run a quick validation:
{{PROJECT_NAME}}).claude/skills/<name>/SKILL.md committedSkill acquired: <skill-name>
- File: .claude/skills/<skill-name>/SKILL.md
- Reference: .claude/skills/<skill-name>/reference.md (if created)
- Invocable: /command (or agent-only)
- Agents: <list of agents>
- Registered in: CLAUDE.md
- Sources: N consulted
Next: Test the skill by running /<command> or delegating to an agent.
| Parameter | Required | Type | Description |
|---|---|---|---|
$ARGUMENTS | Yes | string | Skill name or capability description |
| Output | Type | Description |
|---|---|---|
| SKILL.md | .md file | Complete skill definition |
| reference.md | .md file | Companion reference (if needed) |
| CLAUDE.md update | edit | Skill registered in project docs |
| Agent updates | edit | Skill added to agent definitions |
| Git commit | commit | All artifacts committed |
| Error | Action |
|---|---|
| Skill already exists | Offer to enhance the existing skill instead |
| Insufficient documentation available | Create a minimal skill with TODOs, flag for manual completion |
| Topic too broad for one skill | Propose splitting into multiple focused skills |
| Cannot determine which agents need it | Ask user which agents should have access |
/acquire-skill azure-blob-storage
The mobile-engineer reports they don't know how to configure EAS
submissions. Running /acquire-skill eas-submit to create the skill.