ai-ready

Scan codebase structure and convention files to generate or refresh AGENTS.md.

6|16|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/flightctl/ai-workflows --skill ai-ready-flightctl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-ready
Source: https://github.com/flightctl/ai-workflows/tree/main/ai-ready
Command: npx skills add https://github.com/flightctl/ai-workflows --skill ai-ready-flightctl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI agents struggle when a repo lacks accurate, project-specific guidance, so builds, tests, and conventions get misapplied; this workflow fixes that by generating or updating AGENTS.md based on what actually exists in your codebase.

Core Features & Use Cases

  • Creates or updates AGENTS.md at the project root with concrete build commands, test procedures, code style, architecture, and conventions.
  • Audits tool-specific AI convention files (such as .cursorrules, CLAUDE.md, and .github/copilot-instructions.md) and consolidates redundant generic instructions into AGENTS.md while keeping tool-auto-loaded files as needed.
  • Detects monorepos and recommends adding nested AGENTS.md files for subprojects when the structure supports it.

Quick Start

Run the ai-ready command that executes /ai-ready:update to scan the repository and update the root AGENTS.md using the project’s current files and conventions.

Frequently Asked Questions about ai-ready

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

FAQPage Schema
How do I generate an AGENTS.md file for AI coding agents?

An AGENTS.md file provides AI coding agents with repository-specific instructions, ensuring builds, tests, and conventions are correctly applied. It is needed when AI agents struggle with misapplied conventions due to a lack of accurate project-specific guidance.

How do I consolidate .cursorrules and CLAUDE.md into a single instruction file?

You can consolidate tool-specific AI convention files like .cursorrules and CLAUDE.md by running an audit that merges redundant generic instructions into AGENTS.md. The process keeps tool-auto-loaded files only when necessary for their specific purpose.

Does AGENTS.md generation work for monorepo setups?

Yes, AGENTS.md generation works for monorepo setups by detecting the project structure and recommending nested AGENTS.md files for subprojects. This ensures AI coding agents receive scoped instructions tailored to each specific subproject.

What's the best way to keep AI convention files updated during repo onboarding?

The best way to keep AI convention files updated is to use an idempotent workflow that scans the codebase and refreshes AGENTS.md. It verifies that referenced paths and commands exist, applying to both onboarding and ongoing maintenance workflows.

Why do AI coding agents misapply build commands and tests in my repository?

AI coding agents misapply build commands and tests when a repo lacks accurate, project-specific guidance. Generating an AGENTS.md file based on your actual codebase structure and conventions provides the precise instructions needed to fix this.