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.
Source facts
- Repository
- gmickel/better-skill-builder
- Last source activity
- January 4, 2026 at 16:47
- Detected SKILL.md language
- English
- Stars
- 8
- Forks
- 2
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- better-skill-builder
- description
- 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.
# 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
```yaml
---
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](references/format.md) |
| Adding scripts | [scripts.md](references/scripts.md) |
| Safety/auth/trigger patterns | [patterns.md](references/patterns.md) |
| Installation paths | [installation.md](references/installation.md) |
| Distribution (git/CLI/plugin) | [distribution.md](references/distribution.md) |
| Plugin/marketplace structure | [plugin-structure.md](references/plugin-structure.md) |
| Production examples | [real-examples.md](references/real-examples.md) |
View on GitHub