# Implement Agent Skills > Implement and maintain Claude Agent Skills with valid SKILL.md frontmatter, focused instructions, and progressive disclosure. Use when this capability is needed. - Skill: `tomevault-io/implement-agent-skills-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/implement-agent-skills-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/implement-agent-skills-2/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/implement-agent-skills-2 --- # Implement Agent Skills Create or update `skills//SKILL.md` files with deterministic scope and reusable references/scripts/templates. ## Workflow 1. **Assess complexity**: Use decision framework to determine skill level needed (simple vs workflow) 2. **Start simple**: Choose simplest skill type that meets requirements 3. **Define scope**: Single-purpose objective with clear trigger criteria and success metrics 4. **Create/update**: `skills//SKILL.md` with valid frontmatter 5. **Add supporting materials**: References/scripts/templates for progressive disclosure 6. **Plan evaluations**: Identify 20-50 test cases to validate skill behavior 7. **Validate**: Check frontmatter and directory structure 8. **Cross-link**: Connect to plugin packaging or umbrella guidance as needed ## Progressive Disclosure ### Best Practices (Anthropic Guidelines) - **Complexity decision framework**: `../implement-claude-extensions/references/decision-framework.md` - **Context management patterns**: `../implement-claude-extensions/references/context-management.md` - **Evaluation strategy**: `../implement-claude-extensions/references/evaluation-strategy.md` ### Skill Design Patterns - Skill directory conventions: `references/skill-structure.md` - Required frontmatter fields: `references/skill-frontmatter.md` - Progressive disclosure patterns: `references/skill-progressive-disclosure.md` - Invocation and trigger guidance: `references/skill-invocation.md` ### Validation Tools - Structure validator: `scripts/validate-skill-structure.sh` - Frontmatter checker: `scripts/check-skill-frontmatter.sh` ### Tiered Templates (by Complexity) - **Level 1 - Simple Skill** (Score 1-3): `assets/templates/skill-simple.md` - **Level 2 - Workflow Skill** (Score 4-6): `assets/templates/skill-workflow.md` - Base skill template: `assets/templates/skill-template.md` - Skill with references example: `assets/templates/skill-with-references.md` - Skill with scripts example: `assets/templates/skill-with-scripts.md` ## Related Skills - Umbrella routing and component selection: `../implement-claude-extensions/SKILL.md` - Plugin packaging/distribution: `../implement-plugin/SKILL.md` ## Sources - https://code.claude.com/docs/en/skills - https://code.claude.com/docs/en/plugins --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/yu-iskw) — claim your Tome and manage your conversions.