Skill Authoring Guide
This skill provides a step-by-step guide to crafting effective AI skills, streamlining development and ensuring optimal performance.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add skill-authoring-guide npx -- -y @trustedskills/skill-authoring-guide
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"skill-authoring-guide": {
"command": "npx",
"args": [
"-y",
"@trustedskills/skill-authoring-guide"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
This skill provides a guide for creating and documenting AI agent skills. It helps users understand the process of defining, structuring, and presenting skills within the TrustedSkills registry. The resulting documentation is intended to be clear, concise, and easily discoverable by other agents and developers.
When to use it
- You're building a new skill for an AI agent and need guidance on how to structure its documentation.
- Existing skill documentation needs improvement to ensure clarity and completeness.
- You want to understand the best practices for publishing skills within the TrustedSkills ecosystem.
- You are onboarding new developers to your team who will be creating AI agent skills.
Key capabilities
- Provides guidance on skill structure.
- Offers advice on documentation best practices.
- Supports clear and concise skill descriptions.
- Facilitates discoverability within the TrustedSkills registry.
Example prompts
- "Generate a basic skill guide template."
- "What are the key sections I should include in my AI agent skill's documentation?"
- “Give me an example of how to describe a skill’s capabilities.”
Tips & gotchas
The quality of your skill documentation directly impacts its discoverability and usability. Ensure you follow the guidance provided by this skill to maximize the effectiveness of your published skills.
Tags
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.