If you're not familiar, Agent Skills are the open standard for packaging instructions, scripts, and resources that AI coding agents can discover and use think Claude Code, Cursor, Codex, and dozens of others. It's a simple idea with a lot of power: you write a SKILL.md file, structure a folder around it, and suddenly your agent knows how to do something new.
The concept is great. The setup? Not so much.
The problem I kept running into
Every time I wanted to create a new skills repository, I found myself doing the same tedious dance. Create the folder structure. Write the SKILL.md with the right frontmatter. Set up the .claude-plugin/marketplace.json. Wire up a plugin.json for each skill. Add a GitHub Actions workflow for validation. Write sync scripts to keep the README and marketplace config in sync as skills get added or removed.
Hey Product Hunt! 👋
I created Build Skill, a CLI that scaffolds AI agent skill repositories in seconds. It's like create-react-app, but for AI agent skills.
The problem? Setting up a proper skills repo with the right folder structure, Claude marketplace config, GitHub Actions for validation, and sync scripts sucks.
None of it is hard. All of it is annoying. And if you get the structure wrong, your skills just silently don't work. No error, no feedback, just an agent that doesn't pick up what you built.
Build Skill fixes that:
→ npx build-skill — one command, interactive setup
→ Generates a fully spec-compliant skills repository
→ Includes CI/CD workflows for validation and syncing
→ Ships with helper scripts to add new skills and keep everything in sync
→ Works in quiet mode for CI pipelines
Give it a spin: