skills.rest
nexus-substrate
nexus-substrateOFFICIAL
Explore all skills by this author →
GitHub

system-review

Reconcile technique registries, sync documentation, and audit GitHub issue hygiene.

18|1|Updated Jan 3, 2026
Search Tags:#governance#project health#GitHub issues#documentation drift#system review#maintenance reporting#registry reconciliation
One-click install
npx skills add https://github.com/nexus-substrate/nexus-agents --skill system-review-nexus-substrate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: system-review
Source: https://github.com/nexus-substrate/nexus-agents/tree/main/skills/system-review
Command: npx skills add https://github.com/nexus-substrate/nexus-agents --skill system-review-nexus-substrate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

System review prevents silent drift in documentation, dependency posture, and issue hygiene so project health stays visible and actionable.

Core Features & Use Cases

  • Registry reconciliation: checks research registry technique statuses and validates they align with referenced files.
  • Documentation sync: verifies ARCHITECTURE.md, README.md, CHANGELOG.md, and ALIGNMENT_ROADMAP.md reflect the current reality.
  • Issue health auditing: scans GitHub issues to find orphans, staleness, and label inconsistencies, then produces a consolidated action plan.
  • Use case: after a week of development or when an EPIC closes, run the review to generate a dated maintenance issue that captures drift and next steps.

Quick Start

Ask the agent to run a system review because your open issue count is below 5.

Frequently Asked Questions about system-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect documentation drift and stale GitHub issues in my repository?▼

Documentation drift and stale GitHub issues are detected by running a system review that reconciles technique registries, syncs ARCHITECTURE.md and README.md, and audits issue hygiene to surface orphans and label inconsistencies.

When should I run a project health check to prevent technical debt from compounding?▼

A project health check should be run during low-issue periods, when an EPIC closes, or at periodic intervals to surface drift and stale work before it compounds into larger maintenance problems.

What is registry reconciliation and how does it validate my project files?▼

Registry reconciliation validates project files by checking research registry technique statuses and ensuring they correctly align with the actual referenced files in your repository.

How do I generate a maintenance report that captures action items for issue hygiene?▼

You generate a maintenance report by prompting the agent to audit GitHub issues for staleness and label inconsistencies, which produces a dated maintenance issue capturing evidence and actionable next steps.

Does a system review require specific dependencies or components to run?▼

No dependencies or components are required to run a system review, as the skill operates independently using GitHub querying and structured report generation to perform governance-focused project health checks.

Can I verify that my CHANGELOG.md and ALIGNMENT_ROADMAP.md reflect current project reality?▼

You can verify current project reality by running documentation sync checks that scan CHANGELOG.md and ALIGNMENT_ROADMAP.md to ensure these governance documents accurately reflect the active development state.

Related Skills

Explore More Product & Management Skills→
ShaheerKhawajaShaheerKhawaja
8

document-release

Audit release diffs and update core documentation files to match shipped changes.

Community
Advanced
cameronraysmithcameronraysmith
14

issues-beads-audit

Audit issue graphs for cycles, orphans, and stale entries using the 'bd' tool.

Community
Intermediate
skylarsaboskylarsabo

doc-alignment

Scan codebase documentation, compare it to code, and report drift.

Community
Advanced
RogueRopeRogueRope
2

hugo-content-checker

Audit Hugo content directories for broken links, frontmatter gaps, and duplicates.

Official
Intermediate