Forge Skills

Forge Skills

Forge Skills is a modular engineering Skill collection for Codex, Claude, and Cursor. It combines focused Skill entrypoints with deterministic routing, reusable engineering guidance, validation tooling, and opt-in LLM behavior evaluation.

Requirements

• Python 3.11 or later for Forge validation and installation tooling; CI verifies 3.11, 3.12, and 3.13.
• Node.js 22 or later for the standalone page-test runtime; CI verifies Node.js 22.
• An existing Chrome, Edge, or Chromium installation for standalone browser work. The project never installs a browser automatically.

Install Skills

The installer creates only missing links and preserves existing files, directories, and conflicting links.

Add `--uninstall` to remove only links created from this source checkout. Existing files and links to other sources are preserved. Use `--check --uninstall` to preview removals.

Windows:

install-skills.bat --client codex --scope global
install-skills.bat --client claude --scope global
install-skills.bat --client cursor --scope global

macOS or Linux:

python .forge-skill/forge/scripts/sync-agent-skills.py --client codex --scope global
python .forge-skill/forge/scripts/sync-agent-skills.py --client claude --scope global
python .forge-skill/forge/scripts/sync-agent-skills.py --client cursor --scope global

For one existing project, add `--scope project --project `. Use `--check` first for a read-only installation report.

Default roots are `~/.codex/skills`, `~/.claude/skills`, and `~/.cursor/skills`. Windows uses directory junctions; POSIX systems use directory symlinks.

Validate

Install deterministic development dependencies from `.forge-skill/forge`, then run:

python .forge-skill/forge/scripts/run-local-checks.py --full

The full gate validates UTF-8 text, sensitive-content rul