Claude-skill-registry 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

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/better-skill-builder" ~/.claude/skills/majiayu000-claude-skill-registry-better-skill-builder && rm -rf "$T"

manifest: 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