new-skill SKILL.md skillA

new-skill from pedrohcgs/claude-code-my-workflow is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add pedrohcgs/claude-code-my-workflow/new-skill@git:20260927.177f070

Pins git:20260927.177f070 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
pedrohcgs/claude-code-my-workflow
Path
.claude/skills/new-skill/SKILL.md
Versions recorded
5
Latest version
git:20260927.177f070, committed Sep 27, 2026
First version recorded
Aug 21, 2026
Size
12,173 bytes
Repository stars
1,675
License
MIT

Scaffold a new skill that follows this repo's conventions — interviews for purpose, trigger phrases, and tool needs, then writes `.claude/skills/<name>/SKILL.md` from the skill template with frontmatter and body that pass the integrity gates on first try. Use when user says "write a skill", "scaffold a skill", "create a new skill", "I keep doing X, make it a skill", "new slash command", or "turn this workflow into a skill". NOT for capturing a one-off session discovery — that is `/learn`.

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

# /new-skill — Author a Convention-Compliant Skill

Scaffold a new skill the way this template's gold-standard skills are written: a **deep module behind a simple interface** (Ousterhout, *A Philosophy of Software Design* — "deep modules": a small surface that hides substantial implementation). The user supplies a fuzzy intent; this skill interviews it into a tight spec, then writes `.claude/skills/<name>/SKILL.md` with frontmatter and body that are mutually consistent — so `check-skill-integrity.py` and `check-surface-sync.sh` pass without a second pass.

Adapted from the *write-a-skill* pattern in [mattpocock/skills](https://github.com/mattpocock/skills), reshaped to this repo's frontmatter, section, and gate conventions.

## When to use

- You keep re-explaining the same 3+ step workflow to Claude and want it captured as a reusable slash command.
- You need a domain-specific check or output format (citation style, replication gate, a new review lens).
- You want a new skill that is consistent with the 40+ siblings in `.claude/skills/` — same sections, same cross-reference style, same gate-passing frontmatter.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add pedrohcgs/claude-code-my-workflow/new-skill@sha256:6484c98bf0b98cdd

The line at the top of this page pins the label git:20260927.177f070, 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_fxzhuci3i367v4rt.svg)](https://markdownregistry.com/a/art_fxzhuci3i367v4rt)

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

Versions

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

versioncommittedcommitsizeaudit
git:20260927.177f070 latest2026-09-27 177f070 12,173 BA view · diff
git:20260927.0425fd62026-09-27 0425fd6 11,641 BA view · diff
git:20260927.6535de72026-09-27 6535de7 10,459 BA view · diff
git:20260823.f2143372026-08-23 f214337 9,129 BA view · diff
git:20260821.8a2f8942026-08-21 8a2f894 9,146 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 (12173 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

pedrohcgs/claude-code-my-workflow · 1,675 stars · license MIT · pushed 2026-09-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fxzhuci3i367v4rt
GET https://markdownregistry.com/api/v1/resolve?ref=pedrohcgs/claude-code-my-workflow/new-skill
GET https://markdownregistry.com/api/v1/blob/6484c98bf0b98cddba6d3d6a330c98a98e4faddd506d718981fe333090b387c6

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 pedrohcgs/claude-code-my-workflow

adjudicate-review SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/adjudicate-review/SKILL.md · Turn an incoming set of findings — from an AI reviewer, a referee report, a code review, a linter, or a second model —…
git:20260927.0425fd6 · audit A · 1,675 stars
audit-reproducibility SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/audit-reproducibility/SKILL.md · Enforce the replication-protocol.md rule by cross-checking numeric claims in a manuscript against the actual R / Stata…
git:20260927.6535de7 · audit A · 1,675 stars
blast-radius SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/blast-radius/SKILL.md · Before and after changing anything shared — a function's return value, a signature, a schema, a label set, a config…
git:20260823.6b8fa14 · audit A · 1,675 stars
capture-environment SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/capture-environment/SKILL.md · Snapshot the computational environment for a replication package — detects the analysis stack (R / Stata / Python) and…
git:20260927.6535de7 · audit A · 1,675 stars
challenge SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/challenge/SKILL.md · Stress-test a finding against the choices you did not make. Enumerates the discrete forks a competent analyst could…
git:20260823.6b8fa14 · audit A · 1,675 stars
checkpoint SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/checkpoint/SKILL.md · Save a structured state snapshot before stopping or handing off. Captures the active plan, recent decisions, file…
v1.0.0 · audit A · 1,675 stars
coauthor-brief SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/coauthor-brief/SKILL.md · Generate a co-author / collaborator handoff brief for a multi-author, multi-machine project — summarizing what changed…
v1.0.0 · audit A · 1,675 stars
commit SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/commit/SKILL.md · Commit the current work — runs the quality, consistency and passport gates, branches off main if needed, stages…
git:20260927.0425fd6 · audit A · 1,675 stars
compile-latex SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/compile-latex/SKILL.md · Compile a Beamer LaTeX slide deck with XeLaTeX (3 passes + bibtex). Use when user says "compile", "build the slides"…
git:20260415.3ef908f · audit A · 1,675 stars
compress-session SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/compress-session/SKILL.md · Distill the current conversation into a structured note (decisions made, open questions, file pointers with line…
v1.0.0 · audit A · 1,675 stars
context-status SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/context-status/SKILL.md · Show current context status and session health. Use to check how much context has been used, whether auto-compact…
v1.0.0 · audit A · 1,675 stars
create-lecture SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/create-lecture/SKILL.md · Create a new Beamer lecture `.tex` from source papers and materials, with notation consistency checks and the project's…
git:20260927.6535de7 · audit A · 1,675 stars

Every file in pedrohcgs/claude-code-my-workflow

Other files named new-skill

new-skill SKILL.md skill
hyhmrright/brooks-lint · .claude/skills/new-skill/SKILL.md · Scaffold a new brooks-lint analysis skill so it passes `npm run validate` and `npm run evals` on the first try —…
git:20260528.247b3fd · audit A · 1,554 stars
new-skill SKILL.md skill
hyhmrright/brooks-lint · .agents/skills/new-skill/SKILL.md · Scaffold a new brooks-lint analysis skill so it passes `npm run validate` and `npm run evals` on the first try —…
git:20261016.c7fa1b0 · audit A · 1,554 stars
new-skill SKILL.md skill
hyhmrright/logic-lens · .claude/skills/new-skill/SKILL.md · Scaffold a new logic-* skill in the Logic-Lens repo and wire it into every place a skill must be registered, so no step…
git:20260528.2e39bfc · audit A · 25 stars
new-skill SKILL.md skill
kahl-d/jaja · .agents/skills/new-skill/SKILL.md · Use when a procedure has been repeated by hand twice, or the owner asks to add a skill to the agency or a project…
git:20261023.9f9eaf2 · audit A · 6 stars

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