Skip to content

README.md

Latest commit

 

History

History
77 lines (54 loc) · 1.72 KB

README.md

File metadata and controls

77 lines (54 loc) · 1.72 KB
Raw

Custom Skills Repo

Claude and Codex custom skill monorepo.

This repository provides a small, dependency-light workflow for creating, validating, and packaging reusable custom skills.

Repository Layout

shared/
  scripts/        Automation entry points
  templates/      Source templates for generated skills
  utils/          Shared Python helpers
  constants/      Repository-wide constants
skills/
  skill-template/ Reference skill to copy or inspect
docs/             Development and skill-authoring guides
tests/            Integration tests for repository tooling

Quick Start

Create a new skill:

npm run create -- my-skill --description "Describe what this skill does"

Validate every skill:

npm run validate

Package every skill into dist/:

npm run package

Link every skill into the Claude and Codex skill directories (~/.claude/skills and ~/.codex/skills) so both tools pick them up live:

npm run link

This creates a symlink (or a directory junction on Windows when symlinks are unavailable) per skill, so skills/ stays the single source of truth and edits are reflected immediately. Re-run after adding a new skill. To remove the links:

npm run unlink

Run integration tests:

npm test

Skill Contract

Each skill lives in skills/<skill-name>/ and must include:

  • SKILL.md
  • YAML front matter with name and description
  • Actionable instructions after the front matter

See docs/SKILL_ANATOMY.md for details.

Skill Ideas

Looking for what to build next? See docs/SKILL_IDEAS.md for a brainstormed list of candidate skills, grouped by category with priorities and a scoring table.