Agent Instruction Kit

Русская версия

Portable, versioned skills, rules, prompts, and configurations for AI-assisted software development.

Agent Instruction Kit is a public, vendor-neutral collection of behavioral artifacts for software development agents. It separates reusable instruction sources from tool-specific discovery paths and uses evidence, evaluation, versioning, review, and rollback to control changes.

Current Contents

The repository currently ships one skill:

  • evolve-ai-instructions — improve skills, rules, prompts, policies, and agent instructions from observed evidence without self-approval or irreversible drift.

Rules, system prompts, reusable prompts, and agent configurations will be added only through reviewed changes with tests appropriate to their behavioral impact.

Repository Layout

agent-instruction-kit/
├── skills/                         Canonical skill packages
│   └── evolve-ai-instructions/
├── .agents/skills/                 Relative discovery symlinks; no copied bodies
├── governance/proposals/           Versioned instruction-change proposals
├── prompts/                        Reserved for future system and reusable prompts
├── rules/                          Reserved for future portable rules
├── configurations/                 Reserved for future agent configuration adapters
├── scripts/install_skills.py       Local deployment and drift check
├── tests/                          Contract and installer tests
├── docs/ru/README.md               Russian project documentation
├── CONTRIBUTING.md                 Contribution and review contract
└── LICENSE                         MIT License

Install Locally

The repository is the canonical source. ~/AI-Skills is an installation target and must not contain a Git repository.

uv sync --all-groups
uv run python scripts/install_skills.py

mkdir -p ~/.agents/skills
ln -s ../../AI-Skills/evolve-ai-instructions ~/.agents/skills/evolve-ai-instructions

Check whether installed copies match the repository:

uv run python scripts/install_skills.py --check

Validate

uv run pytest
uv run ruff check .
uv run python skills/evolve-ai-instructions/scripts/validate_proposal.py lint <proposal.json>

Contribution Governance

All changes reach main through pull requests. During the temporary solo-maintainer period, a merge requires:

  1. all required CI checks to pass;
  2. resolved review conversations;
  3. linear squash history and an auditable pull request.

Approving reviews are temporarily not required because GitHub does not allow the sole maintainer to approve their own pull request. Required code-owner plus collaborator approval will be restored when a second authorized account is available. Direct pushes, force pushes, branch deletion, and self-approved instruction promotion remain prohibited. See CONTRIBUTING.md for the artifact and evaluation requirements.

Language Policy

English is the canonical public documentation language. Maintained translations use docs/<language-code>/<same-filename> and link back to the canonical document. Skill-level README files remain inside their skill packages and are independent from this repository-level README pair.

License

Released under the MIT License.