agentsmith

Assemble the right instructions and skills for every agent, machine, and repository.

agentsmith turns reusable, Git-backed source material into the native context files that coding agents already understand. Define templates, packs, and skills once; select them for a machine or repository; then let asmith generate AGENTS.md, CLAUDE.md, and native skill directories.

Install the asmith command from npm with Node 24 or newer, through Homebrew on Apple Silicon macOS, or as a standalone binary from GitHub Releases.

Why agentsmith?

• Keep shared instructions consistent across long-running machines.
• Adapt the same guidance to Codex and Claude Code.
• Compose project context for repositories and monorepo subtrees.
• Generate self-contained skills without runtime include chains.
• Review every change and protect hand-edited output.

Two workflows

Global context

A machine profile selects reusable packs and a template. asmith global sync fast-forwards the source repository and regenerates global instructions and skills.

Project context

A checked-in project config declares repository and subtree scopes. asmith project generate renders local instruction layers and skills without pulling anything.

Start here

1. Install agentsmith.
2. Generate context for a project.
3. Set up synchronized global context.

If you want the model before the mechanics, read packs and templates and projects and scopes.

Learn by role

• I want consistent agents on my computers: follow the personal user walkthrough.
• I write reusable agent skills: follow the skill author walkthrough.
• I maintain context for a repository or monorepo: follow the project maintainer walkthrough.
• I want to see what each feature buys me: browse the feature cookbook.