Agent skill

readiness

Evaluate repository readiness for AI agents. Analyzes 81 criteria across 8 pillars, assigns maturity level 1-5, generates visual report.

View SKILL.md on GitHub Repository
Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/viktor-silakov/readiness/tree/main/skills/readiness

SKILL.md

Repository Readiness Assessment

Audit any repository to determine readiness for autonomous AI agent workflows. Produces a structured report scoring 81 distinct criteria.

Target: Use $ARGUMENTS if a GitHub URL is provided, otherwise analyze the current working directory.

Workflow

  1. Clone if needed — When $ARGUMENTS is a GitHub URL, clone to /tmp
  2. Discover context — Detect languages, locate source/test/config directories
  3. Identify apps — Count deployable units (monorepo services, libraries, etc.)
  4. Evaluate criteria — Score all 81 criteria from CRITERIA.md
  5. Calculate level — Determine maturity level 1-5 based on thresholds
  6. Generate report — Output visual ASCII report per OUTPUT_FORMAT.md
  7. Ask about HTML export — ALWAYS ask the user if they want the D3.js dashboard after the ASCII report; do not proceed until they answer

Boundary Rules

  • Stay within git repository root (where .git exists)
  • Skip .git, node_modules, dist, build, __pycache__
  • Never access paths outside the repository

Language Detection

Language Indicators
JS/TS package.json, tsconfig.json, .ts/.tsx/.js/.jsx
Python pyproject.toml, setup.py, requirements.txt, .py
Rust Cargo.toml, .rs
Go go.mod, .go
Java pom.xml, build.gradle, .java
Ruby Gemfile, .gemspec, .rb

Application Discovery

An application is a standalone deployable unit:

  • Independent build/deploy lifecycle
  • Serves users or systems directly
  • Could function as its own repository

Patterns:

  • Simple repos → 1 app (root)
  • Monorepos → count each deployable service
  • Libraries → 1 app (the library itself)

Scoring Rules

Repository Scope (43 criteria):

  • Evaluated once for entire repo
  • numerator: 1 (pass), 0 (fail), null (skipped)
  • denominator: always 1

Application Scope (38 criteria):

  • Evaluated per-app
  • numerator: count of passing apps
  • denominator: total apps (N)

Maturity Levels

Level Name Requirement
L1 Functional Baseline (all repos start here)
L2 Documented ≥80% of L1 criteria pass
L3 Standardized L2 + ≥80% of L2 criteria pass
L4 Optimized L3 + ≥80% of L3 criteria pass
L5 Autonomous L4 + ≥80% of L4 criteria pass

Evaluation Principles

  • Deterministic: Same repo → same output
  • Existence-based: Prefer file/config existence over semantic analysis
  • Conservative: Ambiguous evidence = fail
  • Concise rationales: Max 500 characters each

Additional Resources

  • CRITERIA.md — Full list of 81 criteria with descriptions
  • OUTPUT_FORMAT.md — ASCII visual report format with ANSI colors
  • templates/report.html — D3.js HTML dashboard template
  • examples/sample-output.md — Example report output

HTML Report Generation (MANDATORY)

IMPORTANT: You MUST ask the user this question every single time after displaying the ASCII report. Do not skip this step and do not proceed until the user responds.

Ask user:

Would you like to generate an interactive HTML report with D3.js charts? [yes/no]

Wait for user response. If yes, use template from templates/report.html and save as readiness-report.html. After generation, always offer to open the report.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore
mattpocock/skills

git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

111,310 9,758
Explore
mattpocock/skills

migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

111,310 9,758
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results