Skip to content
cccskills
FreePublished on GitHubEnglish overview

harness-genome

Assess a repository without changing it and report its type, suggested agent roles, risk, MCP connections, test confidence, and publication readiness. Use the results for setup decisions, comparisons over time, or automated risk checks in CI.

OriginalShow the original description

7-section repo readiness report from `metaharness genome {path}`. Returns repo_type / agent_topology / risk_score / mcp_surface / test_confidence / publish_readiness. Pure-read; degrades gracefully (ADR-150).

AI rating90/ 100See how to install

Good for

  • Reviewing a repository before creating a custom agent harness
  • Comparing reports over time to spot architecture drift
  • Failing a CI build when risk exceeds a chosen threshold
  • Checking test confidence and publication readiness

Overview

What it does

Examines a repository without modifying it and produces a report covering its type, recommended agent roles, risk score, MCP connection arrangement, test confidence, and publication readiness. It reads the results of metaharness genome and outputs JSON or Markdown. Reports remain valid even when the underlying verdict is needs-work or blocked; those verdicts are preserved in the output.

When it helps

Use it to review a repository before building a custom agent harness or to understand its readiness for publication. Saving and comparing reports periodically also lets you track changes in the recommended agent configuration. In CI, you can set a risk threshold and fail the build when the score exceeds it.

Example requests

  • “Check this repository’s risk and publication readiness in JSON.”
  • “Add a CI check using --alert-on-risk-above 0.5.”
  • “Compare this report with an earlier one and identify changes in the recommended configuration.”

Notes

Requires an environment that can run npx metaharness genome <path> --json through Bash. External command execution has a 60-second limit. When the risk threshold option is specified, exceeding that threshold returns exit code 1.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt explicitly identifies reviews before harness creation, configuration drift detection, CI gates, and the fields included in its report.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodIt provides the command, parsed fields, verdict preservation rules, exit codes, and a JSON output example.
SafetyAre sending data, deleting files, and running commands disclosed?
AGoodIt states that analysis is read-only and specifies a 60-second command timeout and the exit behavior when risk exceeds the threshold.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt requires Bash and npx execution but provides no instructions for setting up that environment.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 21, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

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

Files included (1)

  • SKILL.md2.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Companion to harness-score. Where score is a 5-dimension numeric scorecard, genome is a 7-section categorical/numeric report covering repo type, agent topology recommendations, risk score (0-1), MCP surface area, test confidence (0-1), and publish readiness (0-1).

Algorithm

Implementation: scripts/genome.mjs.

  1. Shell out to npx metaharness genome <path> --json (60s hard timeout).
  2. Parse the shape: { repo_type, agent_topology[], risk_score, mcp_surface, test_confidence, publish_readiness }.
  3. Preserve upstream's readiness verdict as verdict and verdictExitCode. Upstream exits 1 for needs-work and 2 for blocked; these are valid reports, so the wrapper returns them successfully.
  4. If --alert-on-risk-above N: exit 1 when risk_score > N.
  5. Output JSON (default) or markdown.

Phase-0 baseline (ruflo, measured 2026-06-16)

{
  "repo_type": "node_mcp_ci",
  "agent_topology": ["maintainer", "tester", "security", "release"],
  "risk_score": 0.27,
  "mcp_surface": "remote",
  "test_confidence": 0.8,
  "publish_readiness": 0.9
}

Ruflo's risk_score: 0.27 is low (good). publish_readiness: 0.9 is high. The mcp_surface: "remote" reflects that ruflo's MCP servers are hosted, not bundled.

When to use

  • Pre-mint review: "before scaffolding a custom harness from this repo, should we?" — genome answers it categorically.
  • Drift detection: capture genome snapshots over time, diff via cost-diff-style tooling to spot when agent_topology recommendations drift away from a deliberate architecture choice.
  • CI gate: --alert-on-risk-above 0.5 fails the build when the repo's risk profile crosses a threshold.

Pairs with

  • harness-score — numeric readiness
  • harness-mcp-scan — static MCP security findings
  • harness-threat-model — enterprise-review-grade threat model

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

add-model-descriptions

FreeSummaryAI rating 80

Compare models available through the HuggingFace router with chat-ui configuration, research missing models, and write short English descriptions of their architecture and capabilities. Add entries to both production and development configuration files and commit the changes.

  • Adding newly available router models to chat-ui
  • Writing concise descriptions of model capabilities
  • Updating production and development model entries together
ruvnet/ruflo78.3KUpdated Oct 21, 2026

adr-create

FreeSummaryAI rating 80

Create an Architecture Decision Record, a document for recording important design choices, with the next sequential number. It generates a Markdown template, registers the record in AgentDB, and links related decisions found through search.

  • Record the reasoning behind adopting a technology
  • Start an ADR for an API or data model change
  • Document an infrastructure decision
ruvnet/ruflo78.3KUpdated Oct 21, 2026

adr-index

FreeSummaryAI rating 90

Build a searchable index and relationship graph from ADRs, records of architectural decisions. Import two supported document formats, refresh existing metadata without duplicate relationships, and review summaries of statuses, missing references, and inconsistencies.

  • Index ADRs imported from another project
  • Refresh a graph that differs from files on disk
  • Set up ADR tracking in an existing codebase
ruvnet/ruflo78.3KUpdated Oct 21, 2026

adr-reindex

FreeSummaryAI rating 70

Rebuild the index of ADRs, records of architectural decisions, after files or relationship lines are deleted. It clears stored records and relationships, indexes the files still present, and checks that the final record count matches.

  • Rebuild the index after deleting an ADR file
  • Remove stale relationships after editing an ADR
  • Reconcile the ADR index on a schedule
ruvnet/ruflo78.3KUpdated Oct 21, 2026

adr-review

FreeSummaryAI rating 80

Review code changes against accepted Architecture Decision Records, documents that capture agreed design choices. Report violations, outdated references, compliant changes, and areas without ADR coverage, then suggest code fixes or a new decision record where appropriate.

  • Check a pull request before merging
  • Review major code changes against agreed design decisions
  • Find references to superseded ADRs
ruvnet/ruflo78.3KUpdated Oct 21, 2026

adr-verify

FreeSummaryAI rating 90

Check saved architecture decision records (ADRs) for broken references, circular replacement relationships, and inconsistent statuses. Use the results to verify imported records or stop a CI check when selected integrity rules fail.

  • Checking ADR integrity after import
  • Blocking CI when ADR issues are found
  • Reviewing ADR data before a release
ruvnet/ruflo78.3KUpdated Oct 21, 2026

See all skills by ruvnet

Report a problem with this skill