planr-spec SKILL.md skillA

planr-spec from openplanr/openplanr is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add openplanr/openplanr/planr-spec@git:20261004.db8c0b9

Pins git:20261004.db8c0b9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
openplanr/openplanr
Path
skills/planr-spec/SKILL.md
Versions recorded
2
Latest version
git:20261004.db8c0b9, committed Oct 4, 2026
First version recorded
Sep 14, 2026
Size
2,960 bytes
Repository stars
5
License
MIT

Shape vague product or engineering intent into a clear, measurable Protocol-compatible specification grounded in the current repository. Use when requirements need clarification before planning or implementation.

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

# OpenPlanr Spec

Shape vague product or engineering intent into a decision-complete
specification inside this active coding session. Do not invoke a planning CLI or
another model process.

## Ground the specification

Read the request, repository instructions, ADRs, product documentation,
existing planning artifacts, relevant implementation code and tests, stack
configuration, design inputs, database context, and current behavior. Infer
facts the repository already answers.

When a missing decision materially changes scope or observable behavior, use
the host's structured question interface. Ask no more than three short,
mutually exclusive questions at once and put the recommended option first. If
the host lacks that interface, ask one concise chat question. Do not present a
long prose questionnaire.

When native agents are available, use the specification role to consolidate the
contract and dispatch database or designer roles only when their lens affects
the decision. Otherwise perform those lenses sequentially in the active agent.

## Author directly

Read [the specification contract](references/specification-contract.md). Write
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add openplanr/openplanr/planr-spec@sha256:040841d2b63504fd

The line at the top of this page pins the label git:20261004.db8c0b9, 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_aebi2phqdb7otyh7.svg)](https://markdownregistry.com/a/art_aebi2phqdb7otyh7)

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

Versions

The registry has recorded 2 versions of this file, between Sep 14, 2026 and Oct 4, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20261004.db8c0b9 latest2026-10-04 db8c0b9 2,960 BA view · diff
git:20260914.622ce312026-09-14 622ce31 2,447 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 (2960 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

openplanr/openplanr · 5 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_aebi2phqdb7otyh7
GET https://markdownregistry.com/api/v1/resolve?ref=openplanr/openplanr/planr-spec
GET https://markdownregistry.com/api/v1/blob/040841d2b63504fd4ad9e07222ba0356cdd3084045fbb70f665bb043e4d006fa

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 openplanr/openplanr

AGENTS.md@packages/cli AGENTS.md file
openplanr/openplanr · packages/cli/AGENTS.md
git:20260914.622ce31 · audit A · 5 stars
CLAUDE.md@packages/cli CLAUDE.md file
openplanr/openplanr · packages/cli/CLAUDE.md
git:20260914.622ce31 · audit A · 5 stars
agile-checklist Cursor rule
openplanr/openplanr · packages/pipeline/.cursor/rules/agile-checklist.mdc · Agile Development Checklist — guides you through the 5-phase agile workflow for planr-pipeline
git:20260914.622ce31 · audit A · 5 stars
create-epic Cursor rule
openplanr/openplanr · packages/pipeline/.cursor/rules/create-epic.mdc · Create an Epic — conversational epic creation for planr-pipeline
git:20261005.d4f1cc8 · audit A · 5 stars
create-features Cursor rule
openplanr/openplanr · packages/pipeline/.cursor/rules/create-features.mdc · Create Features from Epic — break down an epic into features for planr-pipeline
git:20261005.d4f1cc8 · audit A · 5 stars
create-task-list Cursor rule
openplanr/openplanr · packages/pipeline/.cursor/rules/create-task-list.mdc · Create Task List — generate implementation tasks from user stories for planr-pipeline
git:20260914.622ce31 · audit A · 5 stars
create-user-story Cursor rule
openplanr/openplanr · packages/pipeline/.cursor/rules/create-user-story.mdc · Create User Stories — generate user stories with Gherkin acceptance criteria for planr-pipeline
git:20261005.d4f1cc8 · audit A · 5 stars
implement-task-list Cursor rule
openplanr/openplanr · packages/pipeline/.cursor/rules/implement-task-list.mdc · Implement Task List — guidance-first implementation for planr-pipeline
git:20260914.622ce31 · audit A · 5 stars
AGENTS.md@packages/pipeline AGENTS.md file
openplanr/openplanr · packages/pipeline/AGENTS.md
git:20260914.622ce31 · audit A · 5 stars
CLAUDE.md@packages/pipeline CLAUDE.md file
openplanr/openplanr · packages/pipeline/CLAUDE.md
git:20260914.622ce31 · audit A · 5 stars
planr-artifact SKILL.md skill
openplanr/openplanr · skills/planr-artifact/SKILL.md · Open, share, import, or export an OpenPlanr diagram, design, or HTML artifact review. Use when feedback must move…
git:20261006.ac4c5c4 · audit A · 5 stars
planr-browser-qa SKILL.md skill
openplanr/openplanr · skills/planr-browser-qa/SKILL.md · Run practical browser-backed QA against real routes, forms, viewports, accessibility, console, and network behavior…
git:20261004.db8c0b9 · audit A · 5 stars

Every file in openplanr/openplanr

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