ar-agent-ready

Extracts repository conventions into rule files and reports an agent-readiness scorecard.

1|2|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-agent-ready-mahsanamin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ar-agent-ready
Source: https://github.com/mahsanamin/agentic-repos/tree/main/skills/ar-agent-ready
Command: npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-agent-ready-mahsanamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding assistants produce inconsistent output when a repository has no written conventions, forcing engineers to fix style, structure, and workflow mismatches by hand after every session. ## Core Features & Use Cases - Codebase Convention Extraction: Reads the actual code to derive per-area rule files covering error handling, test structure, naming, and module boundaries, adapted to the detected stack. - Config Seam Wiring: Creates or corrects config_hints.json and AGENTS.md with verified build, test, and coverage commands plus the declared tracker and standards location. - Readiness Scorecard: Measures identity, single source of truth, extracted rules, workflow governance, and feedback loop, then reports what is present, added, or still missing. - Use Case: When adopting a new repository, run this Skill to generate docs/ai-rules/ rule files from real code patterns and receive a scorecard showing exactly what remains for a human decision. ## Quick Start Ask the assistant to make this repo agent-ready and extract the coding rules for this project.

Frequently Asked Questions about ar-agent-ready

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make a repository agent-ready for AI coding assistants?▼

Run the agent-ready assessment, which reads the codebase, extracts its real conventions into rule files under a standards location, wires config_hints.json and AGENTS.md, and reports a readiness scorecard showing what is present or missing.

How to extract coding rules from an existing codebase?▼

The Skill delegates a structural read of the code, then derives one focused rule file per convention area from recurring patterns such as error handling, test naming, and module boundaries. Rules come from evidence in the code, not generic templates.

Does agent-ready assessment work with any tech stack or tracker?▼

Yes, the Skill is stack-agnostic and tracker-agnostic. It adapts extracted rules to the detected language and framework, and records whatever tracker the repo declares, including github, jira, linear, or none.

What files does an agent-ready repository need?▼

An agent-ready repo needs config_hints.json for identity and commands, AGENTS.md as the single source of truth, extracted rule files under a standards location such as docs/ai-rules/, the global session hook, and a feedback loop for capturing friction.

When should I use ar-install instead of the agent-ready assessment?▼

Use ar-install for first-time adoption of a whole project with no config seam, since it performs the full adoption. The agent-ready Skill is the lighter, repeatable assess-and-raise pass and the rule-extraction engine ar-install relies on.