← Browse

@merlinhu1/truthmark-realize

A

Use when the user explicitly asks to realize Truthmark truth docs into code, including /truthmark-realize, $truthmark-realize, or /truthmark:realize. Not for syncing docs after code changes, documenting existing code, topology repair, or truth audits.

skillclaude

Install

agr install @merlinhu1/truthmark-realize --target claude

Writes 1 file into .claude/skills/, pinned to git-f5a2e068.

  • .claude/skills/truthmark-realize/SKILL.md

Document


name: truthmark-realize description: Use when the user explicitly asks to realize Truthmark truth docs into code, including /truthmark-realize, $truthmark-realize, or /truthmark:realize. Not for syncing docs after code changes, documenting existing code, topology repair, or truth audits. argument-hint: Optional truth doc path, area, or desired code behavior to realize user-invocable: true

Truthmark Realize

Use this skill only when the user explicitly asks to realize truth docs into code.

Quick procedure:

  • Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
  • Read the source truth docs, inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist, then inspect tests and relevant functional code directly.
  • Truth docs lead; code follows.
  • may write functional code only; must not edit truth docs or truth routing while realizing those docs.

Progressive disclosure:

  • support/procedure.md — read before edits or detailed auditing; contains core review questions
  • support/report-template.md — read before the final report

Trustgrade A

  • passBody integrity

    Whether the stored document is plausibly the kind of file the artifact declares, rather than something fetched by mistake.

  • passType matchnot applicable to this artifact type

    Whether the artifact is really the kind of thing its metadata claims it is.

  • passFreshness

    How long since the source repository was last pushed to.

  • passPrompt injection

    Scans the artifact's own text for instructions aimed at your agent rather than at you.

  • passLicense

    Whether the source repository declares an SPDX license permissive enough to redistribute.

How the grade is calculated

Each check contributes 0 points when it passes, 1 when it warns, and 2 when it fails. The total maps to a letter:

  • Aevery check passed
  • Bone warning
  • Ctwo warnings
  • Dprompt injection or body integrity failed, or three warnings
  • Fone of those failed, and something else is wrong

These are automated hygiene checks, not a security audit, and not a dependency or vulnerability scan. A grade of A means nothing was flagged — not that the artifact is safe.

Versions

  • git-f5a2e0684c9f2026-07-31