2 min read
Skill Library

Built-In Skills

Built-in skills live in four directories:

  • skills/shared — available to all agent tools
  • skills/claude-only — applied only to Claude Code
  • skills/codex-only — applied only to Codex
  • skills/experimental — not applied by default

Curation

Curated shared skills are published to:

~/.agents/skills

Typical flow:

bgng skills list
bgng skills curate <skillName>
bgng apply --skills-only --dry-run
bgng apply --skills-only

Only shared skills can be curated into ~/.agents/skills. Claude-only and Codex-only skills are applied directly to their target-specific skill directories.

Package-Backed Skill Bundles

beginning-harness supports package-backed skill bundles for skills that should be available without being added to the built-in first-party tree.

Typical flow:

bgng library add skill <npm-package-or-local-path>
bgng library list skills
bgng library show <skillName>
bgng add skill <skillName>
bgng apply --dry-run
bgng apply

Global curation remains useful when a shared skill should be available by default across projects:

bgng skills packages add <npm-package-or-local-path>
bgng skills curate <skillName>
bgng apply --skills-only

Added vs. Curated vs. Applied

The distinction matters:

  • Added — the bundle is available under ~/.agents/packages/skills
  • Curated — a shared skill is linked into ~/.agents/skills
  • Applied — the curated skill is linked into downstream tool directories