readiness

Agent Readiness skill for Claude Code - evaluate repository readiness for autonomous AI agents.

Inspired by Factory AI Agent Readiness.

Installation

Via skills.sh (recommended)

npx skills add viktor-silakov/readiness

This is the easiest way to install. The skill will automatically appear in the skills.sh leaderboard based on installation count.

As Claude Code Plugin

claude plugin install readiness@https://github.com/viktor-silakov/readiness

Manual Installation

Clone to your personal skills directory:

git clone https://github.com/viktor-silakov/readiness ~/.claude/skills/readiness

Or to project-level:

git clone https://github.com/viktor-silakov/readiness .claude/skills/readiness

Via npx

npx claude-skill-readiness

This installs the skill to .claude/skills/readiness/ in your project.

Usage

In Claude Code, run:

/readiness

Or with plugin:

/readiness:readiness

What it does

The skill evaluates your repository across 8 pillars and assigns a maturity level 1-5:

8 Pillars

| Pillar | What's checked | |--------|----------------| | Style & Validation | ESLint, Prettier, Biome, formatters | | Build System | package.json scripts, tsconfig, build tools | | Testing | Jest, Vitest, Playwright, test coverage | | Documentation | README, CLAUDE.md/AGENTS.md | | Dev Environment | .nvmrc, .env.example, docker-compose | | Code Quality | TypeScript strict mode, pre-commit hooks | | Observability | Logging, error tracking | | Security | .gitignore, secrets, dependencies audit |

5 Maturity Levels

| Level | Name | Description | |-------|------|-------------| | 1 | Functional | Build works, has entry point | | 2 | Documented | README, installation instructions | | 3 | Standardized | Tests, linting, TypeScript strict | | 4 | Optimized | CI/CD, pre-commit hooks, coverage | | 5 | Autonomous | AGENTS.md, E2E tests, CODEOWNERS |

Output Example

+==============================================================+
|                    AGENT READINESS REPORT                     |
+==============================================================+
|  Repository: my-project                                       |
|  Level Achieved: 4 (Optimized)                                |
|  Overall Score: 78%                                           |
+--------------------------------------------------------------+

PILLAR SCORES
+-------------------------------------------------------------+
| Style & Validation    ████████████░░░░  75%  (3/4 criteria) |
| Build System          ████████████████  100% (4/4 criteria) |
| Testing               ██████████░░░░░░  62%  (5/8 criteria) |
| ...                                                          |
+-------------------------------------------------------------+

Auto-fix

After generating the report, the skill offers to fix common issues:

• Create AGENTS.md with AI agent instructions
• Add .nvmrc with Node version
• Create CODEOWNERS file
• Add missing .gitignore entries
• Configure pre-commit hooks

CLI Commands

npx claude-skill-readiness install   # Install skill (default)
npx claude-skill-readiness check     # Check if installed
npx claude-skill-readiness update    # Update skill files
npx claude-skill-readiness remove    # Remove skill

Requirements

• Node.js >= 18
• Claude Code CLI

License

MIT