Home / llopresto87 / cypress · skills/validate-knowledge/SKILL.md · GitHub

validate-knowledge skillA

validate-knowledge is agent-read markdown (skill) from llopresto87/cypress: Prove that a knowledge base actually works before trusting it — after building or adopting docs, a knowledge graph, or a wiki, verify it can orient a fresh agent and resist false premises. Use at the end of an adoption, after a large docs change, or before relying on the graph to route work. Two methods: clean-context test agents answering known-answer and adversarial questions, and enforcement tests that plant a violation and confirm the linter catches it. A smoke test proves code runs; this pr.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# validate-knowledge

Documentation you wrote is documentation you already believe. That is
exactly why you cannot validate it yourself: you fill every gap from
memory the reader won't have. A knowledge base is only proven when a
context that does *not* share your memory can use it to reach correct
answers — and when its own guard rails demonstrably catch violations.

This complements the code smoke test. A smoke test proves a snippet
runs; this proves the surrounding knowledge is correct, navigable, and
honest.

For version drift specifically — whether the library wiki's pins still
match the resolved dependencies — the complementary check is the
lightweight source-reconciliation pass in `research-and-ingest`; this
skill tests prose, not pin freshness.

## Method 1 — clean-context test agents

Spawn agents with **no prior context** on the project and have them
answer questions using only the knowledge base. Grade the answers
against ground truth you already know.

1. **Give them the entry point, not the answers.** Tell them to read
   the kernel and follow it — the same cold start a real session has.
   Do not paste the facts you're testing for.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add llopresto87/cypress/validate-knowledge@git:20260915.df30567
Exact content
mdr add llopresto87/cypress/validate-knowledge@sha256:39adeb85ef5fbe86

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_x6oaewgl5hhmccbc.svg)](https://markdownregistry.com/a/art_x6oaewgl5hhmccbc)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260915.df30567 latest2026-09-15 df30567 6,814 BA view · diff
git:20260901.c8706d72026-09-01 c8706d7 6,670 BA view · diff
git:20260831.6dde4342026-08-31 6dde434 6,179 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6814 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

llopresto87/cypress · 43 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_x6oaewgl5hhmccbc
GET https://markdownregistry.com/api/v1/resolve?ref=llopresto87/cypress/validate-knowledge
GET https://markdownregistry.com/api/v1/blob/39adeb85ef5fbe86eb0a898db0afaa5869db4ae6573780609f55e6673bb613f0

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from llopresto87/cypress

CLAUDE.md claude
llopresto87/cypress · CLAUDE.md
git:20260924.fae0414 · audit A · 43 stars
AGENTS.md@core agents
llopresto87/cypress · core/AGENTS.md
git:20260915.df30567 · audit A · 43 stars
adopt-existing skill
llopresto87/cypress · skills/adopt-existing/SKILL.md · Source-first growth of an existing single- or multi-repository project into CYPRESS's unified docs/graph knowledge…
git:20260915.df30567 · audit A · 43 stars
adr-writer skill
llopresto87/cypress · skills/adr-writer/SKILL.md · Author an Architecture Decision Record that captures a non-obvious technical choice — its context, the decision, the…
git:20260915.df30567 · audit A · 43 stars
brainstorm-internal skill
llopresto87/cypress · skills/brainstorm-internal/SKILL.md · The divergence technique CYPRESS applies to itself, with no user in the loop — generating genuinely distinct options…
git:20260921.0e86c1a · audit A · 43 stars
brainstorm-socratic skill
llopresto87/cypress · skills/brainstorm-socratic/SKILL.md · The Socratic questioning technique that converges a vague goal — question selection, one-to-three-per-turn pacing, the…
git:20260921.0e86c1a · audit A · 43 stars
context-router skill
llopresto87/cypress · skills/context-router/SKILL.md · Resolve the minimum set of knowledge-graph nodes needed for a task before reading any source file. Use at the START of…
git:20260923.837b1a5 · audit A · 43 stars
grill-planner skill
llopresto87/cypress · skills/grill-planner/SKILL.md · The authoring discipline for the project's plan-of-record at docs/graph/plans/grill.md — what a worker filling any…
git:20260922.d73629d · audit A · 43 stars
holistic-editing skill
llopresto87/cypress · skills/holistic-editing/SKILL.md · The discipline for any change, fix, refactor, or review whose unit of work is larger than a trivial one-liner. Use…
git:20260915.df30567 · audit A · 43 stars
humanizer skill
llopresto87/cypress · skills/humanizer/SKILL.md · Draft or revise prose a person will read (documentation, README text, ADR and spec bodies, runbooks, pull-request…
git:20260915.df30567 · audit A · 43 stars
knowledge-graph skill
llopresto87/cypress · skills/knowledge-graph/SKILL.md · Build and maintain the project's knowledge graph — a tiered set of nodes under docs/graph/ that lets an agent load only…
git:20260917.c81f94c · audit A · 43 stars
library-wiki skill
llopresto87/cypress · skills/library-wiki/SKILL.md · Maintain a project-local, version-pinned wiki of every external dependency. Use whenever a new library is being added…
git:20260922.d73629d · audit A · 43 stars

Every file in llopresto87/cypress

Browse by kind, by grade A, or by owner.