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.

Jump to install

Repository: gmickel/better-skill-builder
Last source activity: January 4, 2026 at 16:47
Detected SKILL.md language: English
Stars: 8
Forks: 1

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/gmickel/better-skill-builder --skill better-skill-builder

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

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

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

Back to search Back to installation

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

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

better-skill-builder

Source facts

Install options

Review the source files

Building Agent Skills

Official Spec

Minimal Structure

SKILL.md Essentials

References

Building Agent Skills

Official Spec

Minimal Structure

SKILL.md Essentials

References