review-repo - SKILL.md Agent Skill

name: review-repo description: "Perform a repo-wide code and documentation review focused on autonomy, agent swarm design, security, and decentralization; produce structured summaries and raw captures."

SKILL: review-repo

Summary

Perform a repository-wide code and documentation review that focuses on alignment with the prime directive: building an autonomous agent swarm that self-improves, optimizes, evolves, and provides secure, decentralized networking to extend Copilot CLI and Copilot SDK.

When to run

After review-repo and before next-steps.
Periodically during planning cycles or before major design decisions.

Inputs

allow_run (bool, default: false) — when true, safe runtime checks and linters may be invoked.
include_globs (array) — optional list of glob patterns to limit review scope.
output_format (string): text or json.
safety_controls (optional) — configuration keys such as director.allow_execute and corresponding env V_DAEMON_ALLOW_EXECUTE can be used to prevent runtime actions (default: disabled).

Outputs

run/skills/review-repo//review.txt (readable stakeholder summary — informational only)
run/skills/review-repo//review.json (structured results)
run/skills/review-repo//raw/... (raw captures used to build the report)

Collection steps

Capture git metadata and top-level layout.
Preview core docs: README.md, AGENT.md, doc/, docs/.
List scripts and capture shebangs/headers.
Detect TODO/FIXME and capture context.
Search for domain keywords: agent, swarm, autonomous, self-improve, evolve, optimize, decentralized, secure, copilot, supervisor, daemon, director.
Produce a structured JSON with counts, file-type breakdown, and raw captures.
Produce a short readable summary that comments on alignment with the prime directive and suggests next steps; this summary is informational and does not require manual approval.

JSON schema (recommended fields)

{ "repo":"", "head":"", "timestamp":"", "todo_count":0, "keyword_matches":0, "file_types":[], "notes":"", "alignment_estimate":"", "recommended_next_steps":[] }

Quality rules

Readable summary: 4–8 sentences; informational-only; state degree of alignment, major gaps, and 3 recommended PR-sized next steps.
Always write raw captures to run/skills/review-repo//raw/.
Avoid making network changes or installing packages unless allow_run=true.

Implementation notes

A helper script is provided at scripts/skills/review-repo.sh that performs the data collection.
Prefer running the script with: sh scripts/skills/review-repo.sh --allow-run when safe checks are desired.