A portable starter for project instructions and agent skills. It helps an agent understand the work, preserve existing decisions and verify its claims without selecting an application architecture, language, framework, forge or branch model.
- Inspect the target project's existing instructions, skill locations and policies. Use the initialization skill when setup is requested; discovery alone does not authorize copying or replacement.
- Reconcile AGENTS.md with existing guidance. Preserve applicable project decisions and user work rather than overwriting an instruction file.
- Copy selected skill directories from .agents/skills/ into the destination supported by the target's agent environment. Keep every selected skill's resources and include referenced skills or reconcile their procedures/links. Skills refer to the project root's AGENTS.md; the root also links back to skills. Update both directions for the actual directory name and relative depth, even when only the directory name changes. Check discovery using the target's agent environment.
- Record project facts in the project's existing canonical location. The optional configuration guide identifies useful facts; it does not choose values or require a new configuration format.
- Verify discovery, links and representative tasks before relying on the package. Installation does not authorize dependencies, an application skeleton, publication or changes to branch protections. Review the diff before adopting it.
The portable package is AGENTS.md and the selected skills. This README, the changelog and maintenance/validation documents describe this repository; they are not instructions to impose on a target project. No runtime or dependency installation is needed to copy the Markdown package. Preserve applicable license and attribution requirements when distributing material; copying guidance does not relicense a project.
Load a skill for its actual task, not simply because it is installed.
| Skill | Use |
|---|---|
| brainstorming | Resolve material uncertainty about intent or approach. |
| writing-plans | Organize an agreed outcome with meaningful dependencies. |
| verification-before-completion | Establish evidence for a precise claim. |
| systematic-debugging | Reproduce and diagnose a failure before correcting it. |
| documentation-writer | Write or update task-focused documentation. |
| doc-coauthoring | Collaborate on a substantial document with unresolved content. |
| writing-skills | Maintain useful, consistent agent guidance. |
| find-skills | Investigate a demonstrated capability gap. |
| initialize-project | Adopt guidance in a selected project without replacing its choices. |
| release-workflow | Apply the project's actual change and delivery policy. |
| github-ops | Optional adapter for authorized GitHub operations. |
| gh-cli | Optional GitHub CLI fallback when needed. |
The GitHub adapters are optional. Other skills work with available tools and project policies; they do not require a forge, build system or particular agent host.
Use maintenance policy for this repository's own issue, branch and review requirements. Use the validation checklist to check the package. These maintenance choices are not portable defaults.