Agent skill
better-skill-builder
Build SKILL.md files for Claude Code, Codex, Amp, OpenCode. Production examples and patterns for skill structure, scripts, distribution, and making CLI tools AI-native.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/better-skill-builder
SKILL.md
Building Agent Skills
Help users build clean, discoverable skills that work across Claude Code, Codex, Amp, and OpenCode.
Official Spec
Fetch from https://agentskills.io/specification for YAML frontmatter, file format, and client integration details.
Minimal Structure
my-skill/
SKILL.md # Required (<500 lines)
references/ # Optional: detailed docs
scripts/ # Optional: executable utilities
SKILL.md Essentials
---
name: my-skill
description: >
What it does. Include trigger phrases so AI knows when to activate.
---
# Title
## When to Use
- Trigger condition 1
- Trigger condition 2
## Quick Reference
[Tables, common commands]
## Detailed Docs
See [references/](references/) for full documentation.
References
| Topic | File |
|---|---|
| Full SKILL.md template | format.md |
| Adding scripts | scripts.md |
| Safety/auth/trigger patterns | patterns.md |
| Installation paths | installation.md |
| Distribution (git/CLI/plugin) | distribution.md |
| Plugin/marketplace structure | plugin-structure.md |
| Production examples | real-examples.md |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?