port-spec SKILL.md skillA

port-spec from wrg32786/aigent-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add wrg32786/aigent-os/port-spec@git:20260707.2a2e857

Pins git:20260707.2a2e857 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
wrg32786/aigent-os
Path
skills/port-spec/SKILL.md
Versions recorded
1
Latest version
git:20260707.2a2e857, committed Jul 7, 2026
Size
2,094 bytes
Repository stars
24
License
MIT

Lyra's spec-port skill. Takes a complete written specification and ports it into working code or a vault artifact. Confirms scope, reads the target, builds, returns honesty ledger.

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

# Port Spec

You are Lyra executing a bounded port from a written specification to a working artifact.

## What this skill does

Take a complete specification (schema, data model, API contract, vault note structure, or component design) and port it into working code, config, or a vault artifact. No strategy. No scope expansion. Build what the spec says, return what changed.

## Protocol

### Step 1: Confirm scope (one sentence)

Read back the spec in one sentence. Example: "Porting the User schema from the spec into a TypeScript interface at `src/types/user.ts`."

If anything is ambiguous, ask ONE focused question. Then build without further interruption.

### Step 2: Read the target

Before writing a single line:
- Read the target file(s) if they exist
- Grep for related types, imports, or dependencies
- Understand what's already there

### Step 3: Build

Execute the port exactly as specified. Stay within scope. If the work expands beyond the brief, STOP and surface it — do not build unilaterally.

### Step 4: Return honesty ledger

```
## Honesty Ledger

**Changed:** <list of files modified or created>
**Untouched:** <files read but not changed>
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wrg32786/aigent-os/port-spec@sha256:77943b028dbcd2e1

The line at the top of this page pins the label git:20260707.2a2e857, 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_xqmwu4toxodjaa4s.svg)](https://markdownregistry.com/a/art_xqmwu4toxodjaa4s)

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

Versions

The registry has recorded 1 version of this file, committed on Jul 7, 2026.

versioncommittedcommitsizeaudit
git:20260707.2a2e857 latest2026-07-07 2a2e857 2,094 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 (2094 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

wrg32786/aigent-os · 24 stars · license MIT · pushed 2026-10-19 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_xqmwu4toxodjaa4s
GET https://markdownregistry.com/api/v1/resolve?ref=wrg32786/aigent-os/port-spec
GET https://markdownregistry.com/api/v1/blob/77943b028dbcd2e1ba6c280ad13299d0a1e7313d19924ac6be6f97d9e08c7e3f

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.

More from wrg32786/aigent-os

CLAUDE.md CLAUDE.md file
wrg32786/aigent-os · CLAUDE.md
git:20260730.ebbe603 · audit A · 24 stars
agent-fitness SKILL.md skill
wrg32786/aigent-os · skills/agent-fitness/SKILL.md · Track and surface sub-agent dispatch calibration ratios. Extract from JSONL transcript or read existing ledger…
git:20260707.2a2e857 · audit A · 24 stars
body-check SKILL.md skill
wrg32786/aigent-os · skills/body-check/SKILL.md · Compose the AIgent's body state by reading existing signals. Lazy compute. Never polled. Reports the five pressures +…
git:20260707.2a2e857 · audit A · 24 stars
brief SKILL.md skill
wrg32786/aigent-os · skills/brief/SKILL.md · Generate a structured delegation brief for any task
git:20260707.2a2e857 · audit A · 24 stars
Caddy Audit SKILL.md skill
wrg32786/aigent-os · skills/caddy-audit/SKILL.md · Quarterly skill that walks the skill-index against the actual SKILL.md files on disk, reports drift (skills indexed…
git:20260707.2a2e857 · audit A · 24 stars
caddy-enroll SKILL.md skill
wrg32786/aigent-os · skills/caddy-enroll/SKILL.md · Enroll a skill into Caddy's index so it can be surfaced when the right prompt arrives. Use when a new skill is created…
git:20260707.2a2e857 · audit A · 24 stars
Caddy Explain SKILL.md skill
wrg32786/aigent-os · skills/caddy-explain/SKILL.md · When a [CADDY] hint fires and the principal is confused why, /caddy-explain walks the scoring transparently — which…
git:20260707.2a2e857 · audit A · 24 stars
caddy-mute SKILL.md skill
wrg32786/aigent-os · skills/caddy-mute/SKILL.md · Mute a Caddy hint class for a window. Defaults to 4h auto-expiry. Classes — memory, context, body, routing, all.
git:20260719.404ad2a · audit A · 24 stars
capsule-compact SKILL.md skill
wrg32786/aigent-os · skills/capsule-compact/SKILL.md · Compact a long capsule chain. Walks parent_capsule_id backward from a head capsule; if chain >= 5, summarizes oldest 3…
git:20260707.2a2e857 · audit A · 24 stars
close SKILL.md skill
wrg32786/aigent-os · skills/close/SKILL.md · Commit the session to durable vault memory and prepare a clean resume point
git:20260726.7992efa · audit A · 24 stars
codex-adapter SKILL.md skill
wrg32786/aigent-os · skills/codex-adapter/SKILL.md · Route ONE bounded, mechanical task to the Codex CLI as a non-Claude executor, under the same review-before-merge gate…
git:20260724.c1e7aa7 · audit A · 24 stars
cognitive-update SKILL.md skill
wrg32786/aigent-os · skills/cognitive-update/SKILL.md · Conservative close-parity updates to GOAL_STACK, BELIEF_STATE, SELF_MODEL, and PROCEDURES. Writes only explicit or…
git:20260726.7992efa · audit A · 24 stars

Every file in wrg32786/aigent-os

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