Home / llopresto87 / cypress · skills/toolcraft/SKILL.md · GitHub

toolcraft skillA

toolcraft is agent-read markdown (skill) from llopresto87/cypress: Doctrine (kernel §3.8) — when an operation will recur across independent sessions, the unit of work is a durable, tested, cataloged tool, not a throwaway script. Defines what counts as a durable tool, what stays disposable, the procedure sibling (a project skill), and the fail-closed rule that a task is incomplete until a durable tool is cataloged or recorded absent. AUTHORING a tool is agent.tool-smith; CATALOGING one happens inside the single canonize close-out spawn. This node is the rule bot.

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

# toolcraft — the durable-tool doctrine

This node owns **the toolcraft rule** (kernel §3.8) — durable tools compound;
throwaway scripts are rework. When an operation will recur across independent
sessions, the unit of work is a **durable, tested tool** with a stable
interface — designed so at plan time, named in `tools_built` on every handback,
and cataloged in `docs/graph/tools/` by the librarian inside the close-out
spawn. Genuine one-offs and throwaway prototypes stay disposable. A task is
**not complete** until any durable tool is cataloged or explicitly recorded
absent.

Work generates capabilities, not only knowledge. A task needs an operation
performed — seed a fixture, migrate a schema, probe an endpoint, regenerate a
client — and an agent writes code to do it. If that code dies with the session,
the next task that needs the same operation writes it again, slightly
differently, with a fresh chance to get it wrong. Toolcraft is the doctrine that
keeps a capability once it is worth keeping.

**This node is the rule, not either half of the work.** Three things used to sit
in one file and are now separate, because they happen at different times and are
…

Read the whole file at its exact version.

How to install

Latest version
mdr add llopresto87/cypress/toolcraft@git:20260915.df30567
Exact content
mdr add llopresto87/cypress/toolcraft@sha256:6587bf072243a87a

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_q7zcg7dyupnocuag.svg)](https://markdownregistry.com/a/art_q7zcg7dyupnocuag)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260915.df30567 latest2026-09-15 df30567 7,580 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 (7580 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_q7zcg7dyupnocuag
GET https://markdownregistry.com/api/v1/resolve?ref=llopresto87/cypress/toolcraft
GET https://markdownregistry.com/api/v1/blob/6587bf072243a87a39e1ac50c1433bb9b39a8e19b9deffd21b2f02495e484782

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.