write-a-skill
Standardizes the process of building new agent skills.
Install
mkdir -p .claude/skills/write-a-skill && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12642" && unzip -o skill.zip -d .claude/skills/write-a-skill && rm skill.zipInstalls to .claude/skills/write-a-skill
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when the user wants to create, write, build, or improve a skill or workflow command.Key capabilities
- →Gather requirements for new skills.
- →Draft `SKILL.md` with progressive disclosure.
- →Include `references/` for richer guidance.
- →Add `examples/` for useful demonstrations.
- →Bundle `scripts/` for deterministic helpers.
How it works
The skill guides the process of creating or improving a skill by gathering requirements, drafting the skill's components, and reviewing it against a checklist.
Inputs & outputs
When to use write-a-skill
- →Developing new skills
- →Improving skill structure
- →Adding workflow commands
About this skill
Write A Skill
Create or improve a skill as its own task, not as part of the orchestrate workflow.
Process
- Gather requirements:
- what task or domain the skill covers
- what use cases it must handle
- whether it needs scripts or only instructions
- what references should shape it
- Draft the skill with:
SKILL.mdreferences/when richer guidance is neededexamples/when examples are usefulscripts/for deterministic helpers
- Review the draft against the skill checklist before finishing.
Rules
- Keep
SKILL.mdconcise and easy for Codex to select. - Put richer guidance in
references/instead of bloatingSKILL.md. - Make the description specific enough that Codex can distinguish the skill from others.
- Include escape hatches for ambiguous input.
Resources
- Skill authoring guide:
references/skill-authoring.md
When not to use it
- →When the task is not about creating, writing, building, or improving a skill or workflow command.
- →When the skill description is not specific enough to distinguish it from others.
Limitations
- →Keep `SKILL.md` concise.
- →Put richer guidance in `references/` instead of bloating `SKILL.md`.
- →Make the description specific enough that Codex can distinguish the skill from others.
How it compares
This skill provides a structured process for skill creation, ensuring proper documentation and bundled resources, unlike ad-hoc skill development.
Compared to similar skills
write-a-skill side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| write-a-skill (this skill) | 0 | 3mo | No flags | Intermediate |
| codex-cli-bridge | 9 | 9mo | Review | Intermediate |
| skill-forge | 11 | 9mo | Review | Intermediate |
| obsidian-data-handling | 4 | 25d | No flags | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
codex-cli-bridge
alirezarezvani
Bridge between Claude Code and OpenAI Codex CLI - generates AGENTS.md from CLAUDE.md, provides Codex CLI execution helpers, and enables seamless interoperability between both tools
skill-forge
WilliamSaysX
Automated skill creation workshop with intelligent source detection, smart path management, and end-to-end workflow automation. This skill should be used when users want to create a new skill or convert external resources (GitHub repositories, online documentation, or local directories) into a skill. Automatically fetches, organizes, and packages skills with proactive cleanup management.
obsidian-data-handling
jeremylongshore
Implement vault data backup, sync, and recovery strategies. Use when building backup features, implementing data export, or handling vault synchronization in your plugin. Trigger with phrases like "obsidian backup", "obsidian sync", "obsidian data export", "vault backup strategy".
flow-next-setup
gmickel
Optional local install of flowctl CLI and CLAUDE.md/AGENTS.md instructions. Use when user runs /flow-next:setup.
rsyslog-doc-dist
rsyslog
Ensures doc/Makefile.am stays in sync with changes to documentation files.
custom-workers
ruvnet
Create and run custom background analysis workers with composable phases. Use when you need automated code analysis, security scanning, pattern learning, or API documentation generation.