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.From its SKILL.md

Install

npx -y skills add gmickel/better-skill-builder

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
fetches URLsInstructs the agent to fetch 1 URL, including https://agentskills.io/specification.

SKILL.md

1.5 KB, 311 tokens by cl100k_base, as published. Nobody here has run it

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

What ships with it: 12 files

29.5 KB alongside SKILL.md