grace-status

Summarize GRACE project health across artifacts, code metrics, and knowledge graph alignment.

233|51|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/osovv/grace-marketplace --skill grace-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grace-status
Source: https://github.com/osovv/grace-marketplace/tree/main/skills/grace/grace-status
Command: npx skills add https://github.com/osovv/grace-marketplace --skill grace-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a concise health assessment for GRACE repositories to surface drift, missing contracts, unpaired semantic blocks, and gaps between the knowledge graph and codebase so teams can prioritize fixes and next steps.

Core Features & Use Cases

  • Artifacts Status: Verifies presence and versions of AGENTS.md and key docs such as docs/knowledge-graph.xml, docs/requirements.xml, docs/technology.xml, and docs/development-plan.xml.
  • Codebase Metrics: Counts total source files, files with and without MODULE_CONTRACT, total semantic blocks, and reports unpaired blocks as integrity violations.
  • Knowledge Graph Health: Compares modules declared in the knowledge graph with modules found in the codebase and highlights orphaned or missing entries.
  • Recent Changes & Suggestions: Extracts the most recent CHANGE_SUMMARY entries and recommends targeted actions like running grace-plan, grace-generate, grace-execute, grace-multiagent-execute, grace-refresh, or grace-verification based on detected issues.

Quick Start

Generate a project health report for the current GRACE repository and suggest the next actions to resolve detected issues.

Frequently Asked Questions about grace-status

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

FAQPage Schema
How do I detect drift and missing module contracts in a GRACE repository?

To detect drift and missing module contracts in a GRACE repository, generate a health report that counts files with and without MODULE_CONTRACT, flags unpaired semantic blocks as integrity violations, and highlights mismatches between the knowledge graph and codebase.

What does project health assessment check for in knowledge graph alignment?

Project health assessment checks knowledge graph alignment by comparing modules declared in docs/knowledge-graph.xml against modules found in the codebase, highlighting orphaned or missing entries to surface gaps for prioritized fixes.

How do I audit GRACE documentation artifacts and their versions?

To audit GRACE documentation artifacts, generate a project health report that verifies the presence and versions of key files including AGENTS.md, docs/requirements.xml, docs/technology.xml, and docs/development-plan.xml.

Can I get actionable next steps based on detected codebase issues?

You can get actionable next steps by extracting recent CHANGE_SUMMARY entries and mapping detected issues to recommended grace CLI commands like grace-plan, grace-generate, grace-execute, grace-refresh, or grace-verification.

Does this project health check require any external dependencies?

This project health check requires no external dependencies and applies directly to GRACE-based repositories to instantly audit project integrity, count semantic blocks, and summarize recent changes.

What is the best way to surface unpaired semantic blocks in my codebase?

The best way to surface unpaired semantic blocks is to run a codebase metrics count that identifies total semantic blocks and reports any unpaired blocks directly as integrity violations within the health status summary.