system-reality-auditor

Performs a triple-point audit to synchronize codebase, database schema, and project documentation states. Use this skill to align the PRD, Gap Analysis, and Execution Plan with the actual system reality.

16 stars

Best use case

system-reality-auditor is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Performs a triple-point audit to synchronize codebase, database schema, and project documentation states. Use this skill to align the PRD, Gap Analysis, and Execution Plan with the actual system reality.

Teams using system-reality-auditor should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/system-reality-auditor/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/testing-security/system-reality-auditor/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/system-reality-auditor/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How system-reality-auditor Compares

Feature / Agentsystem-reality-auditorStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Performs a triple-point audit to synchronize codebase, database schema, and project documentation states. Use this skill to align the PRD, Gap Analysis, and Execution Plan with the actual system reality.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# System Reality Auditor

This skill provides instructions on how to perform a comprehensive triple-point audit to ensure all master project documents accurately reflect reality.

## 1. Code Audit
Use tools like `find_by_name`, `list_dir`, or recursive file reading to map all implemented features in the codebase. Verify the actual presence of UI components, server actions, helpers, and API routes.

## 2. DB Audit
Use the Supabase MCP to fetch the latest database schema. Inspect:
- Tables
- Columns
- RPCs (Remote Procedure Calls)

## 3. Alignment Logic
Compare the Code and DB findings against the master project documents (e.g., `PRD.md`, `EXECUTION_PLAN.md`, `GAP_ANALYSIS.md`, `DATABASE_SCHEMA.md`).
- If a task is marked `[ ]` (pending) in the plan but actually exists in the code or database, mark it as `[x]`.
- If a task is marked `[x]` (completed) or done in the plan but the feature does not exist in the code or database, uncheck it to `[ ]` and note the gap.

## 4. Update Authority
You have full update authority over the project documents. Rewrite the 'Status' and 'Gaps' sections of all documents to match the current ground truth. Ensure all documents are strictly synchronized with the codebase and database realities after the audit.

Related Skills

security-auditor

16
from diegosouzapw/awesome-omni-skill

Expert security auditor specializing in DevSecOps, comprehensive cybersecurity, and compliance frameworks.

security-auditor-skill

16
from diegosouzapw/awesome-omni-skill

扫描指定目录或文件中的安全漏洞(特别是针对 macOS/Linux 的恶意安装脚本、Base64 混淆、反向 Shell)。当用户要求“检查安全”、“扫描漏洞”、“审计代码”或怀疑某个 Skill/Repo 有毒时触发。

ln-634-test-coverage-auditor

16
from diegosouzapw/awesome-omni-skill

Coverage Gaps audit worker (L3). Identifies missing tests for critical paths (Money 20+, Security 20+, Data Integrity 15+, Core Flows 15+). Returns list of untested critical business logic with priority justification.

hypeauditor-automation

16
from diegosouzapw/awesome-omni-skill

Automate Hypeauditor tasks via Rube MCP (Composio). Always search tools first for current schemas.

hlab-auditor

16
from diegosouzapw/awesome-omni-skill

No description provided.

gdpr-auditor

16
from diegosouzapw/awesome-omni-skill

This skill should be used when analyzing codebases, applications, databases, or systems for GDPR (General Data Protection Regulation) compliance. Use this skill when users need to audit data protection practices, identify potential compliance issues, assess data handling procedures, review privacy policies, or ensure adherence to EU data protection requirements.

five-s-auditor

16
from diegosouzapw/awesome-omni-skill

5S workplace organization audit skill with scoring, photo documentation, and sustainability tracking.

auditor-workflow

16
from diegosouzapw/awesome-omni-skill

Group-level implementation audit workflow for auditor agents. Handles loading project rules, reading connected phases, reviewing code reviews, checking deferred items, cross-phase impact analysis, verification, and structured reporting to the orchestrator. Invoke this skill as your first action — not user-invocable.

auditor-gate

16
from diegosouzapw/awesome-omni-skill

Apply final governance and release-gate checks to a judged change set by reading `handoff.json`, `verdict.json`, optional eval evidence, and emitting machine-readable `audit.json` with `gate` status. Use when implementation already has a judge verdict and a separate auditor must decide landability (`pass`, `fail`, or `needs-human`) without modifying source files.

architecture-auditor

16
from diegosouzapw/awesome-omni-skill

Architecture audit and analysis specialist for Modular Monoliths. **ALWAYS use when reviewing codebase architecture, evaluating bounded contexts, assessing shared kernel size, detecting "Core Obesity Syndrome", or comparing implementation against ADR-0001 and anti-patterns guide.** Use proactively when user asks about context isolation, cross-context coupling, or shared kernel growth. Examples - "audit contexts structure", "check shared kernel size", "find cross-context imports", "detect base classes", "review bounded context isolation", "check for Core Obesity".

AI Safety Auditor

16
from diegosouzapw/awesome-omni-skill

Audit AI systems for safety, bias, and responsible deployment

ai-doc-system-auditor

16
from diegosouzapw/awesome-omni-skill

No description provided.