machinery SKILL.md skillA

machinery from ramxx/machinery is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ramxx/machinery/machinery@v0.11.2

Pins v0.11.2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ramxx/machinery
Path
skills/machinery/SKILL.md
Versions recorded
9
Latest version
v0.11.2, committed Oct 6, 2026
First version recorded
Sep 24, 2026
Size
25,637 bytes
Repository stars
14
License
Apache-2.0

Design software as a build-ready blueprint for greenfield, brownfield, rebuild, or hybrid work. Use for domain modeling, C4 architecture, state machines, formal verification, legacy adoption, and zero-context BUILD handoffs under hard TDD. Do not use for ordinary implementation-only tasks.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# machinery

Turn product intent and existing evidence into a checked design that an
implementation agent can execute under hard TDD. The deliverable is the design,
not production code.

This entrypoint is deliberately short. Read only the references selected by the
current phase; do not load the entire methodology at once.

## Runtime contract

Use capabilities, not host names. The skill, artifacts, and `machinery` CLI are
portable. Subagents and hooks are optional accelerators:

- Use fresh-context `machinery-fsm-author` and `machinery-build-writer` roles
  when available; otherwise execute their installed instructions inline.
- Hooks may protect generated files and run checks. Without hooks, treat
  generated artifacts as read-only and run checks explicitly.
- In archaeology, use codebase-memory graph tools before broad filesystem
  discovery whenever they are available.
- Keep artifacts free of host-specific commands, models, sockets, or metadata.

The design contract is identical across Claude Code, Codex, OpenCode, and other
Agent Skills runtimes.

Hook Stop and SubagentStop defer while background tasks run, preserving pending
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ramxx/machinery/machinery@sha256:01d0441d896aff05

The line at the top of this page pins the label v0.11.2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 9 versions of this file, between Sep 24, 2026 and Oct 6, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
v0.11.2 latest2026-10-06 e45350e 25,637 BA view · diff
v0.11.12026-10-06 df7d091 25,637 BA view · diff
v0.11.12026-10-06 1e5a4b3 25,402 BA view · diff
v0.11.02026-10-06 f0f074f 25,402 BA view · diff
v0.11.02026-10-06 8c620d8 24,154 BA view · diff
v0.10.32026-10-06 f7c079a 24,154 BA view · diff
v0.10.32026-10-04 9c7263b 21,728 BA view · diff
v0.10.22026-10-04 5c79b83 21,728 BA view · diff
v0.10.12026-09-24 86ede48 21,728 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the 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 (25637 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

ramxx/machinery · 14 stars · license Apache-2.0 · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_eerfnflhgb6lhn3q
GET https://markdownregistry.com/api/v1/resolve?ref=ramxx/machinery/machinery
GET https://markdownregistry.com/api/v1/blob/01d0441d896aff05ed9a0e95ceb75ac6d8d6fed728ff0869060855bc96ba5153

Your AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

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