Skills Reference

Skills are split into base skills and project-local packs.

Base Install

npx skillpacks init

Installs only:

• packs/base/claude/*
• packs/base/codex/*

It does not install domain packs as base skills.

npx skillpacks init installs these base skills into the current repository's local .claude/skills/ and .codex/skills/ roots, records base_skills: true in .agents/project.json, and keeps them refreshable with npx skillpacks refresh. Base skills are project-local only — there is no user-home (global) base install. To clean up deprecated user-home skillpacks state, run npx skillpacks cleanup --global; add --dry-run to preview the cleanup first. Plain npx skillpacks cleanup removes stale BIP config from projects below the current directory.

Project Pack Commands

npx skillpacks list
npx skillpacks recommend
npx skillpacks install <pack-or-skill>
npx skillpacks remove <pack-or-skill>
npx skillpacks which <skill>
npx skillpacks refresh
npx skillpacks status

Project designation is stored in .agents/project.json.

install <name> accepts either a pack name or a skill name from any pack. Pack names install all skills in that pack; skill names install only that one local skill and store {skill: pack} provenance under .agents/project.json enabled_skills.

The scoped alias package @glexcorp/gskp is published from the same release artifact and version. npx @glexcorp/gskp install <pack-or-skill> is equivalent to npx skillpacks install <pack-or-skill>.

npx skillpacks list-packs is an internal subcommand used by Codex $exec routing (see packs/base/codex/exec/SKILL.md). It prints enabled packs from .agents/project.json one per line with no decoration, distinct from the human-facing list which enumerates all available packs. Prefer list or status for interactive use.

refresh recreates project-local skill roots from .agents/project.json; it does not reload an active Claude Code or Codex process. Start a fresh CLI session after pack changes if the changed skills are not visible.

For workflow ordering, lead-in recommendations, and overlay dependencies, see docs/pack-workflow-matrix.md.

Next-Step Validity

Recommended next steps are governed by docs/skill-next-step-contracts.md. A skill may recommend another skill only when the target skill exists in the active platform/pack context and the current end state satisfies that target's prerequisites. Multi-state skills must branch by end state, and a terminal "no useful follow-up" state should say No follow-up skill recommended rather than invent work.

Public Skills Catalog Export

agentic-skills owns the canonical skills/package source and publishes a committed export contract for public consumers:

• exports/skills-catalog/v1/catalog.json
• exports/skills-catalog/v1/proof.json
• exports/skills-catalog/v1/manifest.json

When a tracked SKILL.md, PACK.md, package manifest, or package-generated skillpacks manifest changes, refresh and validate the export before shipping:

node scripts/generate-skills-catalog-export.mjs
scripts/validate-skills-catalog-export.sh

Consumers select source with SKILLS_REPO_URL and SKILLS_REPO_REF. Release and deploy consumers should pin SKILLS_REPO_REF to a tag or commit SHA rather than a moving branch. The Skills Showcase app lives in the separate agentic-skills-showcase repository and imports these exports; it no longer writes generated website assets back into this repo.

Benchmark Coverage

Benchmark harnesses, raw runs, reports, matrices, and benchmark summary exports live in the separate agentic-skills-benchmarks repository. Normal agentic-skills skill/package shipping does not update benchmark reports or run a benchmark matrix generator.

When a shared skill is created or materially updated and benchmark coverage is needed, update agentic-skills-benchmarks against a pinned agentic-skills export ref. Any public benchmark summary used by the Showcase is generated from the benchmark repo, not during normal skills/package shipping here.

Base Skills

Base skills are domain-neutral and installed project-local via npx skillpacks init for every project. The base surface is intentionally small — 14 skills under packs/base/claude/, 11 of them mirrored under packs/base/codex/:

Three base skills are Claude-only (no packs/base/codex/ mirror): autoresearch, autoresearch-prep, and fork-idea-branch.

Tracked-file mutation skills follow docs/github-delivery-contract.md: the base GitHub subskills are universally available, ordinary shipping stops at a ready pull request, and merge/release/deploy remain separate gated actions.

All other formerly-base skills now live in domain packs — see Moved Skills and the per-pack sections below.

delegate (moved to the agent-bridge pack)

delegate is no longer a base skill — it now lives in packs/agent-bridge/claude/delegate. It remains Claude-only with no Codex mirror, so $delegate does not exist in Codex; install it with npx skillpacks install agent-bridge (or npx skillpacks install delegate).

/delegate is the synchronous sibling of /handoff --target=codex: it drafts and approves a packet using the shared scripts/approved-plan.sh helpers, then invokes codex exec "<target-skill> --execute-approved" inside the current Claude session instead of handing off for the user to resume later. It is hybrid-only by design and falls cleanly into the pre-start-failure branch of the fallback matrix if the codex binary is missing. See packs/agent-bridge/claude/delegate/SKILL.md for the full contract and docs/operating-modes.md § "Approval packet" for the lifecycle states.

Business Packs

Install the narrow business lane needed for the current phase:

npx skillpacks install business-research
npx skillpacks install customer-lifecycle
npx skillpacks install business-growth
npx skillpacks install business-ops

business-app remains a compatibility alias that installs all four.

Business discovery:

customer-discovery, enterprise-icp, competitive-analysis, customer-feedback,
value-prop-canvas, lean-canvas, positioning

Customer lifecycle:

journey-map, onboarding-map, conversion-map, transaction-map,
retention-map, expansion-map, lifecycle-metrics

Business growth:

hook-model, growth-model, metrics, gtm, monetization,
landing-copy, pmf-assessment, experiment

hook-model is an optional pre-UX/product-loop detour when journey evidence shows repeat use or habit formation is central to value. It is not mandatory for every business app; enterprise, infrastructure, transactional, or naturally infrequent products should usually use lifecycle or success measurement instead.

Business ops:

assumption-tracker, cohort-review, retro, risk-register, burn-rate,
runway-model, investor-update, reconcile-research, mvp-gap,
scale-audit, platform-strategy, product-line

Game AFPS Pack

Install in video game and playable entertainment projects:

npx skillpacks install game

With the npm CLI, install the deck as:

npx skillpacks install-deck game-afps

Skills:

game-workflow, game-audience, game-fantasy, game-genre-map,
game-comparables, game-core-loop, game-prototype-test,
game-store-page-test, game-playtest-metrics, game-roadmap, game-launch

Default flow:

game-audience -> game-fantasy -> game-genre-map -> game-comparables
-> game-core-loop -> game-prototype-test -> game-playtest-metrics
-> game-store-page-test -> game-launch -> game-roadmap

Devtool Pack

Install in developer-facing tools, SDKs, CLIs, APIs, libraries, and infrastructure products:

npx skillpacks install devtool

Skills:

devtool-workflow, devtool-user-map, devtool-integration-map,
devtool-dx-journey, devtool-adoption, devtool-positioning,
devtool-monetization, devtool-docs-audit

Default flow:

devtool-user-map -> devtool-integration-map -> devtool-dx-journey
-> devtool-adoption -> devtool-positioning -> devtool-monetization
-> devtool-docs-audit

Code Quality Pack

Install alongside a domain pack when a project needs behavior-preserving code health refactors:

npx skillpacks install code-quality

Skills:

quality-sweep, extract-shared-types

Default flow:

quality-sweep audit -> extract-shared-types / quality-sweep fix -> regression-check

Agentic Skills Bench Pack

Install when working in this repository and measuring one skill with the local verify and benchmark harness:

npx skillpacks install agentic-skills-bench

Skills:

benchmark-test-skill, benchmark-agent-review

Default flow:

benchmark-test-skill <skill> -> benchmark-agent-review <skill> when subjective artifact quality needs review / session-triage on generic or blocked coverage or on failure / ship on pass

Monorepo Pack

Install in pnpm workspace monorepos that may use Turborepo and need package-aware planning, guarded execution, and scoped shipping:

npx skillpacks install monorepo

Skills:

mono-detect, mono-exec, mono-guard, mono-ship

Default flow:

mono-detect -> mono-exec -> mono-guard -> mono-ship

mono-detect writes .agents/monorepo.json with workspace packages, package paths, dependency graph, script inventory, and Turborepo awareness. mono-exec augments standard run with lane-spec generation, mono-guard pre-flight checks, serial cross-cutting work, package-scoped dispatch on separate GitHub branches, and consolidation/PR review before integration. mono-guard validates lane specs before dispatch and audits integrated diffs against declared boundaries and PR-review evidence. mono-ship augments standard ship with package-scoped test/lint/build and transitive-dependent validation before delegating to normal shipping.

The pack uses an augmentation injection pattern rather than a duplication pattern. The base exec and ship skills remain the source of truth for task selection, validation policy, history updates, commit/push, deploy handling, and final next-step routing. The former *-kanban workflow-variant packs are hibernated while Poketo.work is being rebuilt.

Lane dispatch uses .agents/lane-specs.json as the machine-readable artifact and tasks/lane-specs.md as the committed Markdown mirror. Lifecycle values are draft, approved, dispatched, integrated, and failed; package lanes declare packages, owns, must_not_edit, depends_on, mode, and branch. For agent-team work, each write lane must push its non-primary GitHub branch and provide commit SHA, validation evidence, and PR URL before the consolidation/PR review gate approves integration.

Specs and roadmap phases may declare package scope with YAML frontmatter:

---
packages: [api, web]
scope: cross-cutting
---

Use scope: package-scoped for work contained to declared packages, scope: cross-cutting for shared packages or multiple package boundaries, and scope: root-only for root config, scripts, docs, or repository-level policy.

Creator Media Packs

Install the narrow creator-media lane needed for the current phase:

npx skillpacks install creator-foundation
npx skillpacks install youtube-ops

creator-media remains a compatibility alias that installs both.

Creator foundation:

research-directory-conventions,
creator-platform-capability-matrix, creator-evidence-schema,
creator-presence-dossier, creator-positioning, content-programming,
series-spec, product-led-media-map, creator-metrics-review

LinkedIn-first evidence work uses the creator foundation path:

creator-platform-capability-matrix -> creator-evidence-schema -> creator-presence-dossier

Use owner exports, manual snapshots, public unauthenticated captures, and user-provided files as the baseline. Paid APIs, logged-in scraping, bot-protection bypass, private-data collection, private relationship graph extraction, paywall access, and access-control circumvention are out of scope; analytics are unavailable unless owner-provided, admin-provided, or already authorized.

YouTube ops:

youtube-audit, youtube-channel-audit, youtube-video-audit, youtube-video-prelaunch-audit,
youtube-vid-research, youtube-competitive-research, youtube-meta-research, youtube-derivative-cuts,
youtube-title-thumbnail-audit, youtube-description-optimizer,
youtube-portfolio, youtube-peer-benchmark, youtube-search-positioning,
youtube-cadence-diagnosis

Use remotion for format analysis, video scripting, and Remotion build planning.

Project Fleet Pack

Install in control repositories that manage downstream repo portfolios or spin-offs:

npx skillpacks install project-fleet

Skills:

clone-spec-store, project-fleet, spin-off, spinoff-idea

Default flow:

clone-spec-store -> project-fleet -> spinoff-idea -> spin-off

Alignment Loop Pack

Install when a project needs lightweight operator-agent calibration before the full spec-interview pipeline:

npx skillpacks install alignment-loop

Skills:

taste-calibration, destination-doc, vertical-slice-splitter

Default flow:

taste-calibration -> destination-doc -> vertical-slice-splitter -> implementation

Remotion Pack

Install in projects that need Remotion-oriented video production:

npx skillpacks install remotion

Skills:

youtube-format-research, video-script, video-build

Default flow:

youtube-format-research -> video-script -> video-build

Hibernated Kanban Packs

PoketoWork kanban packs are hibernated while Poketo.work is being rebuilt. They are preserved under archive/hibernated-packs/2026-06-poketowork-rebuild/, but are not active install or recommendation targets.

Hibernated packs:

business-app-kanban, devtool-kanban, game-kanban, poketowork-kanban

Hibernated skill surfaces include brainstorm-kanban, spec-interview-kanban, roadmap-kanban, exec-kanban, ship-kanban, ship-end-kanban, poketo-kanban, and sync-roadmap-kanban.

Engineering & Workflow Packs

The pack reorg moved the engineering, git, release, and plan-tracking skills out of base core into narrow packs. Each Skills: list is the authoritative on-disk skill set for that pack.

npx skillpacks install code-debug        # debug, investigate, trace
npx skillpacks install code-review        # dead-code, expert-review, regression-check, slim-audit
npx skillpacks install exec-loop          # exec, ship, ship-end
npx skillpacks install gitops             # commit-and-push-by-feature, sync
npx skillpacks install release-ops        # branch-lifecycle, deploy, release
npx skillpacks install agent-work-admin   # plan-phase, roadmap, spec-drift
npx skillpacks install code-maintenance   # migrate, update-packages
npx skillpacks install docs-health        # hygiene, reconcile-dev-docs
npx skillpacks install repo-maintenance   # bootstrap-repo, env-setup

Two engineering packs are Claude-only (no Codex mirror):

• agent-bridge — delegate (live Claude→Codex delegation; see the delegate note above).
• exec-profile — patch-exec-profile (audit and fill missing lane/branch metadata in agent-team / implementation-safe execution profiles).

Product, Design & Walkthrough Packs

npx skillpacks install product-design       # brainstorm, build-ui-screens, consolidate-prototypes,
                                              #   design-system, feature-interview, logic-wiring,
                                              #   spec-interview, ui-interview, user-flow-map, ux-variations
npx skillpacks install product-testing      # dogfood, uat
npx skillpacks install guided-walkthrough   # guide, uat-guide
npx skillpacks install website-polish       # icon-handler
npx skillpacks install knowledge-check      # quiz-me

Research, Sessions, Context & Skill-Dev Packs

npx skillpacks install research-admin        # research-roadmap
npx skillpacks install session-analytics     # analyze-sessions, session-triage
npx skillpacks install skill-dev             # skill-interview, create-local-skill
npx skillpacks install context-transfer      # handoff
npx skillpacks install teardown              # decommission, desk-flip
npx skillpacks install report-gen            # report-website
npx skillpacks install alignment-page-admin  # compile-central-alignment

Moved Skills

Former base business/product skills now live in narrower project packs. business-app remains a compatibility alias for all four business packs; business-discovery remains a legacy alias for business-research.

Prefer one of:

npx skillpacks install business-research
npx skillpacks install customer-lifecycle
npx skillpacks install business-growth
npx skillpacks install business-ops

The 53-skill base catalog was split into 22 narrower packs in the pack reorg. The engineering and workflow skills that used to be base skills now live in the packs above — code-debug, code-review, exec-loop, gitops, release-ops, agent-bridge, agent-work-admin, code-maintenance, docs-health, and repo-maintenance — and affected/scaffold moved into monorepo. Creator-media and YouTube work is similarly split between creator-foundation, youtube-ops, and remotion. Fleet/portfolio work moved from base core into project-fleet.