skill-intent-contract SKILL.md skillA

skill-intent-contract from nyldn/claude-octopus is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nyldn/claude-octopus/skill-intent-contract@git:20260902.79d62e2

Pins git:20260902.79d62e2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nyldn/claude-octopus
Path
skills/skill-intent-contract/SKILL.md
Versions recorded
5
Latest version
git:20260902.79d62e2, committed Sep 2, 2026
First version recorded
Jul 18, 2026
Size
15,311 bytes
Repository stars
4,409
License
MIT

Use when starting a complex or ambiguous task that risks scope drift.

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

> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.
> Cross-reference commands use installed skill names in Codex rather than `/octo:*` slash commands.
> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.
> For host tool equivalents, see `skills/blocks/codex-host-adapter.md`.

# Intent Contract System

## Purpose

The intent contract creates a **persistent record of user intent** that:
- Captures what the user is trying to accomplish
- Defines success criteria upfront
- Establishes boundaries and constraints
- Travels through the entire workflow
- Validates final outputs against original intent

This closes the loop between intention and delivery.

## Intent Contract Structure

The intent contract is stored in the current resolved plan run directory as `session-intent.md`. Use `scripts/plan-storage.sh` to create or recover that directory; never write a loose intent file into `.claude/`.

```markdown
# Intent Contract

**Created**: [ISO timestamp]
**Workflow**: [discover/embrace/review/etc.]
**Status**: [active/validating/completed]

## Job Statement
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nyldn/claude-octopus/skill-intent-contract@sha256:8ed555eaad55b599

The line at the top of this page pins the label git:20260902.79d62e2, 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_xrumw4yn6fwdo62j.svg)](https://markdownregistry.com/a/art_xrumw4yn6fwdo62j)

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

Versions

The registry has recorded 5 versions of this file, between Jul 18, 2026 and Sep 2, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20260902.79d62e2 latest2026-09-02 79d62e2 15,311 BA view · diff
git:20260813.14437ae2026-08-13 14437ae 14,835 BA view · diff
git:20260809.144704b2026-08-09 144704b 14,804 BA view · diff
git:20260809.3b658262026-08-09 3b65826 12,847 BA view · diff
git:20260718.1809cbe2026-07-18 1809cbe 9,049 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 (15311 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

nyldn/claude-octopus · 4,409 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xrumw4yn6fwdo62j
GET https://markdownregistry.com/api/v1/resolve?ref=nyldn/claude-octopus/skill-intent-contract
GET https://markdownregistry.com/api/v1/blob/8ed555eaad55b599fdd700db2d590c4fbbf1be04fddffd74b26217124ea3c173

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 nyldn/claude-octopus

skill-extract SKILL.md skill
nyldn/claude-octopus · .claude/skills/extract-skill/SKILL.md · Reverse-engineer design systems, tokens, and components from live products or screenshots
git:20260813.14437ae · audit A · 4,409 stars
flow-define SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-define/SKILL.md · Multi-AI requirements scoping using available external providers (Double Diamond Define phase). Priority triggers: octo…
git:20260929.dbf6863 · audit A · 4,409 stars
flow-deliver SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-deliver/SKILL.md · Multi-AI validation, scoring, and review using available external providers (Double Diamond Deliver phase)
git:20261108.8380d65 · audit A · 4,409 stars
flow-develop SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-develop/SKILL.md · Multi-AI implementation using available external providers (Double Diamond Develop phase). DO NOT use for simple code…
git:20261002.5c257fc · audit A · 4,409 stars
flow-discover SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-discover/SKILL.md · Multi-AI research using available external providers (Double Diamond Discover phase)
git:20260929.dbf6863 · audit A · 4,409 stars
flow-parallel SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-parallel/SKILL.md · Decompose and execute large changes, migrations, or multi-issue fixes in parallel with quality gates
git:20261007.9f7aada · audit A · 4,409 stars
flow-spec SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-spec/SKILL.md · NLSpec authoring — use when you need a structured specification from multi-AI research and consensus
git:20261002.5c257fc · audit A · 4,409 stars
skill-agent-topology SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-agent-topology/SKILL.md · Audit whether a multi-agent setup earns its coordination cost — use before adding an agent, or when a workflow feels…
git:20260813.14437ae · audit A · 4,409 stars
octopus-architecture SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-architecture/SKILL.md · Review system architecture, simplify boundaries, or compare interface designs from repository evidence
git:20260907.4febbb1 · audit A · 4,409 stars
skill-audit SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-audit/SKILL.md · Audit codebases for quality, consistency, and broken patterns — use for pre-release or tech debt review
git:20260907.4febbb1 · audit A · 4,409 stars
skill-authoring SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-authoring/SKILL.md · Principles for writing skills that behave the same way every run — use when adding, editing, or reviewing a skill in…
git:20261108.8380d65 · audit A · 4,409 stars
skill-code-review SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-code-review/SKILL.md · Expert multi-AI code review with inline PR comments — use for thorough quality and security analysis
git:20261108.8380d65 · audit A · 4,409 stars

Every file in nyldn/claude-octopus

Other files named skill-intent-contract

skill-intent-contract SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-intent-contract/SKILL.md · Use when starting a complex or ambiguous task that risks scope drift
git:20260902.79d62e2 · audit A · 4,409 stars

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