Better Skill Builder

better-skill-builder

Build Agent Skills for Claude Code, Codex, Amp, and OpenCode.

A skill that teaches you, an AI agent, how to help users build skills. Meta, but useful.

**Claude Code users:** The built-in `claude-code-guide` agent intercepts "Agent Skill" queries. Say "use my skills" or "use better-skill-builder" to use this instead.

Why "Better"?

Anthropic's [skill-creator](https://github.com/anthropics/skills/tree/main/skills/skill-creator) is comprehensive but theoretical. This skill is battle-tested.

	skill-creator	better-skill-builder
Clients	Claude Code only	Claude Code, Codex, Amp, OpenCode
Examples	Theoretical patterns	5 production skills
SKILL.md	~3000 words	~55 lines
Spec handling	Duplicates spec inline	Links to spec
Distribution	.skill files only	git clone, CLI install, plugin, --skill flag
Auth patterns	Not covered	Environment variables, OAuth
Safety patterns	Brief mention	Draft-first, dry-run, confirmation gates
CLI integration	Not covered	skill install --target pattern
Practices what it preaches	No	Yes

**The irony:** skill-creator preaches "context window is a public good" and "keep SKILL.md under 500 lines" but inlines ~3000 words of spec content. We link to [agentskills.io](https://agentskills.io) instead. AI agents know how to fetch URLs. And when the spec updates, our skill stays current automatically.

**This skill teaches from real code, not theory.**

**Official docs:** [agentskills.io](https://agentskills.io)

---

Production Skills

GNO - Local Knowledge Engine

Your local second brain. Index notes, code, PDFs, Office docs. Hybrid search (BM25 + vector + reranking) and AI answers, 100% offline.

bun install -g @gmickel/gno
gno init ~/notes --name notes
gno query "auth best practices"
gno ask "summarize the API" --answer

**Skill install:** ```bash