# 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.

- Skill: `majiayu000/better-skill-builder` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/better-skill-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/better-skill-builder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/better-skill-builder

---


# 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) |