# agentsmith

> Assemble agent instructions and skills for every machine and repository.

## Docs

- [agentsmith](https://niieani.github.io/agentsmith): Assemble the right instructions and skills for every agent, machine, and repository.

## Get started

- [Install agentsmith](https://niieani.github.io/agentsmith/getting-started/install): Install the asmith command from npm, Homebrew, a release archive, or source.
- [Your first project](https://niieani.github.io/agentsmith/getting-started/first-project): Generate AGENTS.md and CLAUDE.md for a Git repository.
- [Global setup](https://niieani.github.io/agentsmith/getting-started/global-setup): Synchronize global instructions and skills across machines with a Git-backed profile.

## Use cases

- [Choose your path](https://niieani.github.io/agentsmith/use-cases/choose-your-path): Start with the agentsmith workflow that matches the job you are doing.
- [Personal user walkthrough](https://niieani.github.io/agentsmith/use-cases/personal-user): Keep Codex and Claude Code context synchronized across a laptop and a long-running workstation.
- [Skill author walkthrough](https://niieani.github.io/agentsmith/use-cases/skill-author): Write one self-contained skill that adapts to GitHub or Linear through selected packs.
- [Project maintainer walkthrough](https://niieani.github.io/agentsmith/use-cases/project-maintainer): Generate layered instructions and skills for a Bun service and an iOS app in one monorepo.
- [Feature cookbook](https://niieani.github.io/agentsmith/use-cases/feature-cookbook): Problem-first examples showing when each agentsmith feature earns its place.

## Guides

- [Projects and scopes](https://niieani.github.io/agentsmith/guides/projects-and-scopes): Model inherited agent context in repositories and monorepo subtrees.
- [Packs and templates](https://niieani.github.io/agentsmith/guides/packs-and-templates): Compose ordered, reusable instruction sets without flattening your source organization.
- [Skills](https://niieani.github.io/agentsmith/guides/skills): Enable, compose, and generate native agent skills at the right scope.
- [Safe workflows](https://niieani.github.io/agentsmith/guides/safe-workflows): Preview changes, protect edits, and use agentsmith confidently in automation.

## Reference

- [Configuration reference](https://niieani.github.io/agentsmith/reference/configuration): Strict TOML schemas for machines, profiles, packs, and projects.
- [Command reference](https://niieani.github.io/agentsmith/reference/commands): Every asmith command, option, and intended workflow.
- [Composition directives](https://niieani.github.io/agentsmith/reference/directives): Slots, required slots, includes, and heading behavior.
- [Source Repository layout](https://niieani.github.io/agentsmith/reference/source-layout): Organize profiles, templates, packs, skills, and partials.
- [Troubleshooting](https://niieani.github.io/agentsmith/reference/troubleshooting): Resolve common configuration, Git safety, composition, and collision errors.