hedgehog-contributing SKILL.md skillA

hedgehog-contributing from skyf0xx/hedgehog is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add skyf0xx/hedgehog/hedgehog-contributing@git:20260909.980f36c

Pins git:20260909.980f36c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
skyf0xx/hedgehog
Path
src/skills/hedgehog-contributing/SKILL.md
Versions recorded
6
Latest version
git:20260909.980f36c, committed Sep 9, 2026
First version recorded
Aug 9, 2026
Size
5,156 bytes
Repository stars
46
License
MIT

Use when the user wants to contribute a fix or roadmap item back to the Hedgehog project itself (skyf0xx/hedgehog) rather than their own project. Triggers on "let's fix that in Hedgehog", "I want to contribute", "let's pick up a roadmap item", or when `tweaker` offers this at the end of a build and the user says yes. Covers forking/branching, making the change under Hedgehog's own repo rules, committing with Conventional Commits, and opening the PR.

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

# Contributing to Hedgehog

Walks a user from "I want to fix/build this in Hedgehog itself" to an open
pull request against `skyf0xx/hedgehog`. This is for changes to the
**discipline** — `src/agents/`, `src/skills/`, `src/templates/`,
`bin/cli.mjs`, `README.md` — never for changes to the user's own project,
which is a different repo with different rules.

## When this runs

- The user names a specific gap (a bug they hit, a roadmap item) and
  wants to fix it in Hedgehog rather than work around it locally.
- `tweaker` offered this at the end of a build and the user said yes.

If the user hasn't picked a target yet, browse issues labeled
[`roadmap`](https://github.com/skyf0xx/hedgehog/issues?q=is%3Aissue+is%3Aopen+label%3Aroadmap)
with them and let them choose one — prefer an issue also labeled
`good-first-issue` for a first contribution, since those are scoped to one
file or one narrow addition.

## Before starting

Confirm where the Hedgehog source actually lives on this machine. A project
that ran `npx @skyf0xx/hedgehog init` has a *copy* of the payload
(`.claude/agents/`, `.claude/skills/`), not the Hedgehog repo itself —
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add skyf0xx/hedgehog/hedgehog-contributing@sha256:1b17e5a236175d23

The line at the top of this page pins the label git:20260909.980f36c, 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_gcxunmex6dvd36qp.svg)](https://markdownregistry.com/a/art_gcxunmex6dvd36qp)

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

Versions

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

versioncommittedcommitsizeaudit
git:20260909.980f36c latest2026-09-09 980f36c 5,156 BA view · diff
git:20260830.6b2a8242026-08-30 6b2a824 5,168 BA view · diff
git:20260827.2afaea62026-08-27 2afaea6 5,269 BA view · diff
git:20260822.0cbaf372026-08-22 0cbaf37 5,688 BA view · diff
git:20260819.9d545c72026-08-19 9d545c7 6,216 BA view · diff
git:20260809.fcf3a2f2026-08-09 fcf3a2f 6,693 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 (5156 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

skyf0xx/hedgehog · 46 stars · license MIT · pushed 2026-10-20 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_gcxunmex6dvd36qp
GET https://markdownregistry.com/api/v1/resolve?ref=skyf0xx/hedgehog/hedgehog-contributing
GET https://markdownregistry.com/api/v1/blob/1b17e5a236175d23065296932f584004b568a3ac7e8806b668e71280b146a33c

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 skyf0xx/hedgehog

bmad-revendor SKILL.md skill
skyf0xx/hedgehog · .claude/skills/bmad-revendor/SKILL.md · Maintainer-only. Use when re-vendoring vendor-skills/BMAD/ against a newer BMAD-METHOD commit — "update BMAD"…
git:20260903.6410e6b · audit A · 46 stars
hedgehog-bot SKILL.md skill
skyf0xx/hedgehog · .claude/skills/hedgehog-bot/SKILL.md · Maintainer-only. Use when the user asks to review, comment on, or merge a pull request on skyf0xx/hedgehog "as…
git:20260828.38e54aa · audit A · 46 stars
inbound-triage SKILL.md skill
skyf0xx/hedgehog · .claude/skills/inbound-triage/SKILL.md · Maintainer-only. Use when triaging inbound GitHub issues and pull requests on skyf0xx/hedgehog — "triage the issues"…
git:20260809.fcf3a2f · audit A · 46 stars
CLAUDE.md CLAUDE.md file
skyf0xx/hedgehog · CLAUDE.md
git:20260915.24d451a · audit A · 46 stars
hedgehog-writing-gate SKILL.md skill
skyf0xx/hedgehog · skills/hedgehog-writing-gate/SKILL.md · Use when the user asks to write, draft, or edit a standalone piece of prose — an article, essay, blog post, tweet…
git:20260905.edb31d7 · audit A · 46 stars
hedgehog SKILL.md skill
skyf0xx/hedgehog · skills/hedgehog/SKILL.md · Use when the user writes the word "Hedgehog" anywhere in a request, or has agreed to install the Hedgehog build…
git:20260905.54f573a · audit A · 46 stars
code-comment-discipline SKILL.md skill
skyf0xx/hedgehog · src/skills/code-comment-discipline/SKILL.md · Apply whenever writing or editing source code in any core's build agent (backend-eng, ui-builder, or equivalent)…
git:20260915.24d451a · audit A · 46 stars
conventional-commits SKILL.md skill
skyf0xx/hedgehog · src/skills/conventional-commits/SKILL.md · Use when uncommitted changes need to be split into atomic, conventional commits ordered for review. Triggers on "commit…
git:20260909.dbddfcb · audit A · 46 stars
filing-issues SKILL.md skill
skyf0xx/hedgehog · src/skills/filing-issues/SKILL.md · Use when filing one or more GitHub issues for planned work — "file an issue for this", "turn this plan into issues"…
git:20260829.d21b372 · audit A · 46 stars
hedgehog-daily SKILL.md skill
skyf0xx/hedgehog · src/skills/hedgehog-daily/SKILL.md · Use when a change request lands on a project that already has `.hedgehog/` and no build in flight — a finished build…
git:20260902.64b33b4 · audit A · 46 stars
hedgehog-orchestrating SKILL.md skill
skyf0xx/hedgehog · src/skills/hedgehog-orchestrating/SKILL.md · Use at the start of any session on a project with a build graph (`.hedgehog/hedgehog.db`), and again at every…
git:20260922.4bb2084 · audit A · 46 stars
hedgehog-planning-intake SKILL.md skill
skyf0xx/hedgehog · src/skills/hedgehog-planning-intake/SKILL.md · Use on any core for first-run planning intake — Phase 0 runs the vendored BMAD-METHOD planning shelf, shared by every…
git:20260905.dede86b · audit A · 46 stars

Every file in skyf0xx/hedgehog

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