Skip to content

🕵️ Palace Auditor Skill

When to use this skill

Use this skill when the user requests a workspace audit, health check, or when preparing for a major structural release to ensure the .agents palace is pristine.

Instructions

  1. Diagnostic Check: Run .\tools\diagnostic.ps1 (or ./tools/diagnostic.sh on Linux) and capture the output. Ensure all dependencies (uv, node, git) and paths are healthy.
  2. OKF Frontmatter Compliance & Signature Audit:
  3. Run uv run python tools/apply_okf_frontmatter.py .agents/brain/ and docs/ to audit and fix any Markdown files missing OKF v0.1 frontmatter headers.
  4. Run python .agents/skills/dsom-signature-injector/scripts/inject.py .agents/brain/ and docs/ to sign any repaired Markdown files lacking standard ownership footers (or operate in check-only mode if executing a dry run).
  5. Index Verification: Read .agents/brain/index.md. Verify that every closet.md or .md file listed under Path: actually exists in the filesystem.
  6. Toolchain Audit:
  7. List all files in the tools/ directory.
  8. List all documentation files in docs/tools/.
  9. Identify any .ps1, .sh, .py, or .js script in tools/ that does NOT have a corresponding structural blueprint in docs/tools/.
  10. Identify any script that lacks either its .ps1 or .sh cross-platform twin.
  11. Report Generation: Create a report artifact for the user summarizing:
  12. System Diagnostic Health.
  13. OKF Frontmatter Compliance Status.
  14. Broken links in index.md (if any).
  15. Undocumented scripts.
  16. Scripts violating the Cross-Platform Mandate.
  17. Propose Actions: Suggest specific actions to resolve the findings.

Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-08-20 Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0