superdev-rules SKILL.md skillA

superdev-rules from p2p2sp/p2p2.claude is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add p2p2sp/p2p2.claude/superdev-rules@git:20260924.1101a9b

Pins git:20260924.1101a9b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
p2p2sp/p2p2.claude
Path
docs/archive/superdev/skills/superdev-rules/SKILL.md
Versions recorded
1
Latest version
git:20260924.1101a9b, committed Sep 24, 2026
Size
5,661 bytes
Repository stars
8
License
MIT

Use ALWAYS when the user wants to discover, capture, or maintain project coding conventions as .claude/rules files - learn the codebase's conventions, set up path-scoped rules, teach Claude the project's style. Triggers include "create rules", "set up .claude/rules", "capture coding conventions", "learn our conventions", "add naming/testing/error-handling rules", "audit rules". Discovers dominant patterns from the host code with real examples, confirms each in an interview, and writes MANY…

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

# SuperDev Rules

Discovers the host project's coding conventions (naming, testing, error-handling, imports, ...) and persists them as `.claude/rules/*.md`. This skill is the interactive front: it scans, asks, and resolves every decision with the user, then hands ONE capture file to the `superdev:rules-writer` agent, which writes the rule files.

## Core Principle

**Many SMALL files, one convention area per file**, each gated by a narrow frontmatter `paths:` glob list - the harness loads a rule only when Claude reads a matching file. No monolith; no global rule where a narrow glob suffices. Record only the DELTA from what a competent developer would do anyway.

**Frozen `_` convention.** A basename with a leading underscore (`_{topic}.md`) is frozen: the native loader still loads it, but this skill never reads, scores, audits, or proposes it - reserved for hand-authored or bootstrap meta-rules that must stay immutable. Never emit a capture slug starting with `_`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add p2p2sp/p2p2.claude/superdev-rules@sha256:57253ead4e412427

The line at the top of this page pins the label git:20260924.1101a9b, 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_voa3tunlyzl6xvuf.svg)](https://markdownregistry.com/a/art_voa3tunlyzl6xvuf)

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

Versions

The registry has recorded 1 version of this file, committed on Sep 24, 2026.

versioncommittedcommitsizeaudit
git:20260924.1101a9b latest2026-09-24 1101a9b 5,661 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 (5661 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

p2p2sp/p2p2.claude · 8 stars · license MIT · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_voa3tunlyzl6xvuf
GET https://markdownregistry.com/api/v1/resolve?ref=p2p2sp/p2p2.claude/superdev-rules
GET https://markdownregistry.com/api/v1/blob/57253ead4e4124270cb4c54d184f7580e8d8d826d785394cfb25724e9b61e409

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 p2p2sp/p2p2.claude

CLAUDE.md CLAUDE.md file
p2p2sp/p2p2.claude · CLAUDE.md
git:20261021.e0a0e76 · audit A · 8 stars
signoz SKILL.md skill
p2p2sp/p2p2.claude · devtools/skills/signoz/SKILL.md · SigNoz logs, dashboards and alerts through its HTTP API.
git:20261016.1921705 · audit A · 8 stars
CLAUDE.md@docs CLAUDE.md file
p2p2sp/p2p2.claude · docs/CLAUDE.md
git:20261007.aaa7079 · audit A · 8 stars
CLAUDE.md@docs/archive/superdev CLAUDE.md file
p2p2sp/p2p2.claude · docs/archive/superdev/CLAUDE.md
git:20261007.aaa7079 · audit A · 8 stars
CLAUDE.md@docs/archive/superdev/skills CLAUDE.md file
p2p2sp/p2p2.claude · docs/archive/superdev/skills/CLAUDE.md
git:20261007.aaa7079 · audit A · 8 stars
adr SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/adr/SKILL.md · Judges an intent interview's confirmed decisions against the three ADR criteria (hard to reverse, surprising without…
git:20260924.1101a9b · audit A · 8 stars
e2e SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/e2e/SKILL.md · Generate and locally verify Playwright tests for the scenarios of one docs/qa handoff file, then commit them for CI.
git:20260924.1101a9b · audit A · 8 stars
executor SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/executor/SKILL.md · Runs ONE build, test, lint, type-check or other shell command in a forked context and returns a short verdict - the…
git:20260924.1101a9b · audit A · 8 stars
intent SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/intent/SKILL.md · You MUST ALWAYS use this skill every time a user wants to do something creative - a new idea, a new feature, build…
git:20260924.1101a9b · audit A · 8 stars
phases-reviewer SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/phases-reviewer/SKILL.md · Invoked only by phases skill.
git:20260924.1101a9b · audit A · 8 stars
phases SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/phases/SKILL.md · Cuts one confirmed intent into ordered phases, saves phases.md plus one intent.md per phase, and resumes a phased run…
git:20260924.1101a9b · audit A · 8 stars
setup SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/setup/SKILL.md · Setup superdev environment.
git:20260924.1101a9b · audit A · 8 stars

Every file in p2p2sp/p2p2.claude

Other files named superdev-rules

superdev-rules SKILL.md skill
p2p2sp/viber · docs/archive/superdev/skills/superdev-rules/SKILL.md · Use ALWAYS when the user wants to discover, capture, or maintain project coding conventions as .claude/rules files -…
git:20260924.1101a9b · audit A · 8 stars

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