Hooks

TypeScript tooling for Claude Code skills.

npx @4meta5/skills-cli scan

What It Does

• Scans your project and recommends relevant skills based on your stack
• Installs skills from curated sources or custom repositories
• Validates skills for quality and correctness (including optional agents/openai.yaml metadata)
• Syncs CLAUDE.md to keep skill references current

Skills

This CLI manages skills from 4meta5/skills.

Core skills include: tdd, code-review-ts, code-review-rust, differential-review, refactor-suggestions, repo-hygiene, and more.

Skills are automatically recommended when you run skills scan.

Quick Start

# Install globally
npm install -g @4meta5/skills-cli

# Scan project for recommendations
skills scan

# Install a skill
skills add tdd

# List installed skills
skills list

Example Output

$ skills scan

Analyzing project...

Detected Stack:
  Languages:     TypeScript 5.0.0 (high)
  Testing:       Vitest (high)

Recommended Skills:

  DEVELOPMENT
  + tdd (4meta5-skills)
    Detected TypeScript (package.json typescript dependency)
    7 alternative(s) available

Commands

Command	Description
scan	Analyze project and recommend skills
add <name>	Install a skill
remove <name>	Remove a skill
list	List installed skills
show <name>	Show skill details
validate [path]	Validate skill quality
update	Update skills from sources
sync	Sync skills to tracked projects
sync --push	Install a skill into tracked projects that do not have it yet
hook	Manage Claude Code hooks
hygiene	Detect and clean slop

Run skills <command> --help for command-specific options.

Priority Rollout

Use the local rollout script to update selected hooks/skills from ../skills into priority projects (../claudette-codes, ../claudette) and install paul-graham for Codex:

./scripts/rollout-priority.sh

You can pass explicit project paths:

./scripts/rollout-priority.sh ../claudette-codes ../claudette

Skill Metadata

Skills may include optional UI metadata at <skill-name>/agents/openai.yaml. When present, skills validate checks that it parses as YAML and that interface.default_prompt references $<skill-name>.

Packages

Package	Description	npm
@4meta5/skills-cli	CLI for discovering and installing skills
@4meta5/skills	Core skills library
@4meta5/skill-loader	Skill loading and parsing
@4meta5/chain	Skill chaining and workflow enforcement

Development

npm install
npm run build
npm test

License

MIT