Skip to content
cccskills
FreePublished on GitHub

agent-ready-eval

Evaluate a codebase for agent-friendliness based on autonomous agent best practices. Use when asked to "evaluate for agents", "check agent readiness", "audit for autonomous execution", "assess agent-friendliness", or when reviewing infrastructure for unattended agent operation. Also use when asked about making a codebase more suitable for AI agents or autonomous workflows.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md3.9 KB
  • metadata.json1.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Agent-Ready Evaluation

Evaluate how well a codebase supports autonomous agent execution based on the "How to Get Out of Your Agent's Way" principles.

Core Philosophy

Autonomous agents fail for predictable reasons—most are system design failures, not model failures. This evaluation checks whether infrastructure enables true autonomy: agents that run unattended, isolated, reproducible, and bounded by system constraints rather than human intervention.

Evaluation Process

1. Gather Evidence

Explore the codebase for indicators across all 12 principles. Key files to examine:

Environment & Isolation:

  • Dockerfile, docker-compose.yml, .devcontainer/
  • Makefile, setup.sh, bootstrap.sh
  • CI configs (.github/workflows/, .gitlab-ci.yml, Jenkinsfile)
  • Nix files, devbox.json, flake.nix

Dependencies & State:

  • Lockfiles (package-lock.json, yarn.lock, Pipfile.lock, Cargo.lock, go.sum)
  • Database configs, migration files, seed scripts
  • .env.example, config templates

Execution & Interfaces:

  • CLI entry points, bin/ scripts
  • API definitions, OpenAPI specs
  • Background job configs (Sidekiq, Celery, Bull)
  • Timeout/limit configurations

Quality & Monitoring:

  • Test suites, benchmark files
  • Logging configuration
  • Cost tracking, rate limiting setup

2. Score Each Principle

Read evaluation-criteria.md for detailed scoring rubric.

Score each of the 12 principles 0-3:

  • 3: Fully implemented with clear evidence
  • 2: Partially implemented, room for improvement
  • 1: Minimal awareness, significant gaps
  • 0: No evidence

3. Generate Report

Output format:

# Agent-Ready Evaluation Report

**Overall Score: X/36** (Y%)
**Rating: [Excellent|Good|Needs Work|Not Agent-Ready]**

## Summary
[2-3 sentence assessment of overall agent-readiness]

## Principle Scores

| Principle | Score | Evidence |
|-----------|-------|----------|
| 1. Sandbox Everything | X/3 | [brief evidence] |
| 2. No External DB Dependencies | X/3 | [brief evidence] |
| 3. Clean Environment | X/3 | [brief evidence] |
| 4. Session-Independent Execution | X/3 | [brief evidence] |
| 5. Outcome-Based Instructions | X/3 | [brief evidence] |
| 6. Direct Low-Level Interfaces | X/3 | [brief evidence] |
| 7. Minimal Framework Overhead | X/3 | [brief evidence] |
| 8. Explicit State Persistence | X/3 | [brief evidence] |
| 9. Early Benchmarks | X/3 | [brief evidence] |
| 10. Cost Planning | X/3 | [brief evidence] |
| 11. Verifiable Output | X/3 | [brief evidence] |
| 12. Infrastructure-Bounded Permissions | X/3 | [brief evidence] |

## Top 3 Improvements

1. **[Highest impact improvement]**
   - Current state: ...
   - Recommendation: ...
   - Impact: ...

2. **[Second improvement]**
   ...

3. **[Third improvement]**
   ...

## Strengths
- [What the codebase does well for agents]

## Detailed Findings
[Optional: deeper analysis of specific areas]

Rating Scale

  • 30-36 (83-100%): Excellent - Ready for autonomous agent execution
  • 24-29 (67-82%): Good - Minor improvements needed
  • 18-23 (50-66%): Needs Work - Significant gaps to address
  • 0-17 (<50%): Not Agent-Ready - Major architectural changes needed

Quick Checks

If time is limited, prioritize these high-signal indicators:

  1. Dockerfile exists? → Sandboxing potential
  2. Lockfiles present? → Reproducibility
  3. No external DB in default config? → Isolation
  4. CLI scripts in bin/ or Makefile? → Direct interfaces
  5. Tests with assertions? → Verifiable output

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

[00] TnR ABSOLUTE RIGOR — Systemic Verification Doctrine. Forced cognitive exertion for high-stakes investigations. Mandates absolute deconstruction, mathematical proof chains, and ≥95% derived certainty. Zero-tolerance for heuristics or sentiment-based reasoning. Shortcuts are defined as intentional hallucinations.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

2agent

Free

Configures 2-Agent workflow between PM and implementation roles. Use when user mentions 2-Agent, 2エージェント, PM連携設定, Cursor設定, Cursor連携, 2-agent運用. Do NOT load for: 単独運用, ワークフロー実行, ハンドオフ処理.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

Appends relevant hashtags to journal entries based on content analysis. Intended for LLM execution.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

Add a new AI coding agent to Agent Sandbox. Creates all required files (Dockerfile, templates, CI, docs) and wires the agent into the CLI, proxy, and build system.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

Add a new property to the AI agents database. Use when the user wants to add, create, or introduce a new column, property, field, or feature to track across all agents in the comparison matrix. Handles all four required steps - database updates, groups.json, table display, and GitHub issue templates.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

Add new Agent templates to the meta-agent-skills framework.

The English summary is being prepared. Showing the original description.

diegosouzapw/awesome-omni-skill64Updated Mar 2, 2026

See all skills by diegosouzapw

Report a problem with this skill