| name | skill-authoring |
| display_name | Skill Authoring |
| description | Helps create, review, and improve agent skill markdown with strong trigger descriptions, concise workflows, metadata, validation, and examples. |
| category | documentation |
| version | 1.0.0 |
| tags | ["skills","authoring","documentation","metadata","agents"] |
| providers | ["claude-code","codex","copilot","openclaw","hermes-agent"] |
| author | agent-skills contributors |
Skill Authoring
Use this skill when creating or improving an AI agent skill, prompt package, or reusable markdown workflow.
Inputs
- Skill goal, target users, expected trigger phrases, examples, draft markdown, or existing skill folder
- Target providers or compatibility requirements
Steps
- Clarify the task the skill should handle and when an agent should use it.
- Write a description that includes the action, domain, and trigger conditions.
- Keep the body concise: inputs, steps, outputs, and guidelines.
- Add tags that improve search and filtering.
- Add provider metadata when the skill is compatible across agents.
- Move detailed examples or long reference material into reference files when needed.
- Validate frontmatter, file naming, category placement, and discoverability.
- Review whether the skill gives useful procedural knowledge rather than generic advice.
Output
Return:
- Improved skill markdown or review notes
- Metadata recommendations
- Trigger and searchability improvements
- Validation issues
- Suggested tests or example prompts
Guidelines
- Prefer concrete workflows over broad principles.
- Avoid bloated skills that consume context without improving execution.
- Make the skill useful to an autonomous agent, not just a human reader.
