Installation

Foundry follows the standard Agent Skills format: each skill is a folder containing SKILL.md, references/, and assets/. Installation means copying the three skill folders into your agent's skills directory.

Requirements

• An agent that supports the Agent Skills format (OpenCode, Claude Code, or compatible).
• git on your machine.

Install

Clone the repository, then copy the three skill folders into your skills directory.

OpenCode / Claude-style agents auto-discover skills in ~/.agents/skills/ and ~/.claude/skills/.

macOS / Linux

git clone https://github.com/MaoyuanYang/foundry.git
cp -r foundry/skills/coding-start      ~/.agents/skills/
cp -r foundry/skills/project-onboard   ~/.agents/skills/
cp -r foundry/skills/feature-dev       ~/.agents/skills/

Windows (PowerShell)

git clone https://github.com/MaoyuanYang/foundry.git
Copy-Item -Recurse foundry\skills\coding-start    $HOME\.agents\skills\
Copy-Item -Recurse foundry\skills\project-onboard $HOME\.agents\skills\
Copy-Item -Recurse foundry\skills\feature-dev     $HOME\.agents\skills\

Then restart your agent so it re-scans the skills directory.

Verify

For OpenCode, run:

opencode debug skill

You should see coding-start, project-onboard, and feature-dev listed with their locations. Each skill also validates against the Agent Skills schema (name + description frontmatter, lowercase-hyphen folder names).

What you get

Skill	Folder	Purpose
coding-start	skills/coding-start/	Greenfield project initialization (0 → 1)
project-onboard	skills/project-onboard/	Brownfield takeover and AS-IS baseline
feature-dev	skills/feature-dev/	Single-feature lifecycle (1 → N)

Each skill is self-contained:

• SKILL.md — the entry point, trigger conditions, and state machine.
• references/ — detailed rules loaded on demand at specific stages.
• assets/ — templates for the documents the skill generates.
• agents/openai.yaml — host display metadata.

Updating

Pull the latest and re-copy the three folders (they are self-contained, so replacing the folder is safe):

cd foundry && git pull
cp -r skills/coding-start skills/project-onboard skills/feature-dev ~/.agents/skills/

Your project files (AGENTS.md, docs/, specs/) are never touched by an update — Foundry only changes how the agent works, not what it already produced.

Uninstall

Remove the three folders from your skills directory and restart your agent:

rm -rf ~/.agents/skills/coding-start ~/.agents/skills/project-onboard ~/.agents/skills/feature-dev

Next

• The three skills — what each does and when it triggers.
• Workflow & gates — how a feature moves from idea to DONE.
• Reference — status glossary and template map.