agent-toolkit

A collection of generic agentic tools for common engineering tasks, designed to work with any AI agent on any kind of software project. The philosophy behind the toolkit — five pillars and a litmus test for every new artifact — is captured in docs/core-philosophy.md.

Skills

Agentic skills for everyday software engineering — solo or in a team, not bound to any specific language or framework.

Skill & doc authoring

Tools to create and continuously improve the skills and docs your agents rely on, following this approach to agentic skills.

• compact-docs-writer — write docs with maximum token economy.
• compact-skill-creator — create or edit skills, keeping them lean and efficient.
• self-improve — capture a lesson into the skill or doc that governs it, so mistakes aren't repeated and agents keep getting better at the project.

Context & memory hygiene

Maintenance to run from time to time, keeping your setup tidy and your context sharp.

• context-checkup — audit what auto-loads into a session's context and spot what can be trimmed to reduce startup tokens. Why this is important.
• memory-doctor — clean up the memory your agents keep auto-accumulating, moving the relevant parts to the right place. More about this.

Task workflow

A daily routine for any programming task, following the RPA workflow: fetch a ticket, refine it, plan it, then let a fresh session execute it.

• fetch-ticket — download a ticket from any tracker (e.g. GitHub, Jira, Azure DevOps) and save it as a self-contained markdown file.
• refine-ticket — define the "what" of a task: validate the ticket — or a raw idea you want to brainstorm — against the codebase, settle open decisions together, and save a self-contained requirements doc a fresh session can pick up.
• create-implementation-plan — define the "how" of a task: turn the requirements into an implementation plan, settling the technical decisions together, then save it for a fresh session to execute.
• create-manual-test-instructions — derive manual test steps from a ticket or requirements file, useful for the developer or QA.
• handover — package a finished change for its reviewers: what it does and why, the decisions and plan deviations worth knowing, and a review guide — paste-ready as the PR description.

Review assistants

Review helpers that check the codebase while assisting with code or ticket reviews.

• fetch-pr-review — collect the comments left by other reviewers on your PR and save them into a markdown doc, ready to address (or push back on), for example via refine-pr-review.
• refine-pr-review — go through a fetched PR review together, comment by comment — address, partial, or push back — drafting the replies and turning the accepted changes into a requirements doc.
• review-code-assistant — assist you in reviewing a PR or branch.
• use-conversational-language — the voice for text that should read as if a person typed it, used by the review skills for comments and replies and by rules for user-facing texts and code comments.
• review-ticket — triage a ticket or ticket set before anyone picks it up, saving a review with a feature walkthrough and the decisions to raise with the team.
• verify-understanding — explain the feature back in your own words before building it: a teach-back conversation over a saved ticket review that probes and corrects until you are ready to implement.
• check-ticket-implementation — check how much of a ticket is already implemented in the code, marking each requirement as done, partial, or not done in a human-readable status report.
• fresh-eyes-review — let an agent with a fresh perspective review a changeset and report its findings back to the main session.

Code checks

• run-nx-checks — run format, lint, test, and build on the affected projects of an Nx workspace and fix unambiguous failures.

How to install the skills

Install all skills in one command:

git clone https://github.com/eai-org/agent-toolkit.git && cd agent-toolkit && ./install.sh

Update in one command:

cd agent-toolkit && git pull && ./install.sh

How the symlink install works and the other install methods — hand-picking skills, other agents, skills.sh, the Claude Code plugin marketplace — are covered in docs/install-skills.md.

Rules

A set of generic, project-agnostic, opinionated rules that apply to any codebase. They are opt-in, installed separately from the skills.

• compact-governing-docs — run the matching compaction skill before writing or editing a governing doc, so it stays compact.
• git-read-only-by-default — never commit, push, merge, or otherwise write to git without an explicit instruction.
• no-ai-attribution — no AI co-author trailers on commits and no "Generated with" footers on PRs.
• no-nonsense-comments — write only code comments that still make sense to a future reader with zero context, prefer no comment over a low-value one, and voice them via use-conversational-language.
• plans-directory — save plans and similar documents under the project's planning directory, following a certain structure.
• read-other-repos-governing-docs — before editing another repo's files, read and follow that repo's governing docs — they don't auto-load.
• self-contained-docs — keep planning and design docs concise and executable by a fresh session with no prior context.
• self-improve-on-correction — when the user corrects something a skill or doc governs, offer to persist the lesson via self-improve.
• write-realistic-texts — make user-facing text sound natural, no AI-generated nonsense.

How to install the rules

Because rules are always-on, they are never installed implicitly with the skills. To opt in:

./install-opinionated-rules.sh

Auto-loaded rules are mostly a Claude Code feature — how they work, which agents support them, the script's options, and linking individual rules by hand are covered in docs/install-rules.md.

Install with agentwheel

agentwheel installs this repo's rules and skills into your agent and keeps them in sync across Claude, Codex, Copilot, and other runtimes, from one source. Run it from where you want it installed (~ for user level, or a project root):

npx agentwheel install github:eai-org/agent-toolkit --adapter claude

Other adapters, selecting individual pieces, and the OpenPack manifest are covered in docs/install-with-agentwheel.md.

Artifact relationships

Some skills and rules form a workflow or rely on each other. Hard dependencies are encoded in openpack.json; suggested next steps live in the skill text.

flowchart TD
  fetch_ticket["fetch-ticket"] --> refine["refine-ticket"]
  fetch_pr["fetch-pr-review"] --> refine_pr["refine-pr-review"]
  refine_pr --> refine
  refine_pr --> plan
  refine_pr --> express["use-conversational-language"]
  review_code["review-code-assistant"] --> express
  realistic_rule["write-realistic-texts rule"] --> express
  nonsense_rule["no-nonsense-comments rule"] --> express
  review_ticket["review-ticket"] --> fetch_ticket
  review_ticket --> express
  review_ticket --> verify_understanding["verify-understanding"]
  check_impl["check-ticket-implementation"] --> fetch_ticket
  refine --> manual["create-manual-test-instructions"]
  refine --> plan["create-implementation-plan"]
  plan --> handover["handover"]
  handover --> express

  self_rule["self-improve-on-correction rule"] --> self["self-improve"]
  self --> compact["compact-skill-creator"]
  self --> compact_docs["compact-docs-writer"]
  compact --> compact_docs
  memory_doctor["memory-doctor"] --> self
  compact_gov["compact-governing-docs rule"] --> compact
  compact_gov --> compact_docs

  plans_rule["plans-directory rule"] -. informs .-> fetch_ticket
  plans_rule -. informs .-> fetch_pr
  plans_rule -. informs .-> refine_pr
  plans_rule -. informs .-> refine
  plans_rule -. informs .-> manual
  plans_rule -. informs .-> plan
  plans_rule -. informs .-> review_ticket
  plans_rule -. informs .-> check_impl
  plans_rule -. informs .-> handover

  docs_rule["self-contained-docs rule"] -. informs .-> fetch_ticket
  docs_rule -. informs .-> fetch_pr
  docs_rule -. informs .-> refine_pr
  docs_rule -. informs .-> refine
  docs_rule -. informs .-> manual
  docs_rule -. informs .-> plan