raise-issue SKILL.md skillA

raise-issue from adamlinscott/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add adamlinscott/claude-skills/raise-issue@git:20261008.fda8754

Pins git:20261008.fda8754 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
adamlinscott/claude-skills
Path
skills/raise-issue/SKILL.md
Versions recorded
4
Latest version
git:20261008.fda8754, committed Oct 8, 2026
First version recorded
Aug 11, 2026
Size
17,357 bytes
Repository stars
3
License
MIT

[Adam''s Skills] Turns "this is broken" into a well-formed issue in the team''s tracker, written in the codebase''s own vocabulary. Built for someone who uses the product and does not read code — it asks a few plain-English questions, works out for itself which part of the code they are describing, checks whether the same thing has already been reported, and files it, but only after they say yes. Use when the user says something is broken, looks wrong, isn''t working, is behaving oddly, seems…

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

# Raise an issue

A good bug report is not a good description. It is a description a developer can act on before
they have found the code themselves. That translation is the whole job here.

The person running this skill uses the product. They do not read code, and they should not have
to. They will say "the dashboard", "the thing that sends the emails", "the export button spins
forever". Your job is to take those words, find what they point at in this repository, confirm
the match in plain English, and hand a complete brief to whoever picks the issue up — so nobody
has to come back and ask this person a technical question.

## Why this skill can be triggered by the model

The omission of `disable-model-invocation` is deliberate, not an oversight.

The people this skill exists for do not know it exists. They will not type `/raise-issue`; they
will say "this looks wrong" and wait. Model invocation is the only mechanism that reaches them.

Being model-invocable is not unusual here — most of this collection is. What is unusual is the
**blast radius**. Every other model-invocable skill in this collection reports, audits, or edits
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add adamlinscott/claude-skills/raise-issue@sha256:c553ec0545f42338

The line at the top of this page pins the label git:20261008.fda8754, 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_wb2kkvdiutunf3fp.svg)](https://markdownregistry.com/a/art_wb2kkvdiutunf3fp)

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

Versions

The registry has recorded 4 versions of this file, between Aug 11, 2026 and Oct 8, 2026, about one every 19 days.

versioncommittedcommitsizeaudit
git:20261008.fda8754 latest2026-10-08 fda8754 17,357 BA view · diff
git:20260911.623fe4a2026-09-11 623fe4a 16,959 BA view · diff
git:20260910.7e7f4622026-09-10 7e7f462 16,956 BA view · diff
git:20260811.52413682026-08-11 5241368 16,936 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 (17357 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

adamlinscott/claude-skills · 3 stars · license MIT · pushed 2026-10-30 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wb2kkvdiutunf3fp
GET https://markdownregistry.com/api/v1/resolve?ref=adamlinscott/claude-skills/raise-issue
GET https://markdownregistry.com/api/v1/blob/c553ec0545f423387bf038d29519a9c3fe46481050ff8f09d11ad0d80be9065b

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 adamlinscott/claude-skills

are-we-done SKILL.md skill
adamlinscott/claude-skills · skills/are-we-done/SKILL.md · [Adam''s Skills] Deterministic close-out gate for a session or work tree. Sweeps a fixed set of sources — the todo…
git:20261030.7081899 · audit A · 3 stars
assumption-inventory SKILL.md skill
adamlinscott/claude-skills · skills/assumption-inventory/SKILL.md · [Adam''s Skills] DEPRECATED — superseded by /build-it. Do not use for new work. Surfaced the load-bearing assumptions…
git:20260911.623fe4a · audit A · 3 stars
brief-me SKILL.md skill
adamlinscott/claude-skills · skills/brief-me/SKILL.md · [Adam''s Skills] DEPRECATED — superseded by /where-are-we. Do not use for new work. Printed a plain-English re-entry…
git:20261026.c0a4905 · audit A · 3 stars
build-it SKILL.md skill
adamlinscott/claude-skills · skills/build-it/SKILL.md · [Adam''s Skills] Build a piece of work, from wherever it is written down — a ticket number or URL, a plan or spec file…
git:20261008.a87265d · audit A · 3 stars
check-skill-updates SKILL.md skill
adamlinscott/claude-skills · skills/check-skill-updates/SKILL.md · [Adam''s Skills] Check whether the installed copy of this skills collection is behind its remote, and offer to update…
git:20261026.c0a4905 · audit A · 3 stars
context-audit SKILL.md skill
adamlinscott/claude-skills · skills/context-audit/SKILL.md · [Adam''s Skills] Audits a repository''s Claude context-injection setup — CLAUDE.md, CONTEXT.md, docs/, .claude/agents/…
git:20261008.fda8754 · audit A · 3 stars
debrief SKILL.md skill
adamlinscott/claude-skills · skills/debrief/SKILL.md · [Adam''s Skills] BETA / under development. Mine the current project''s Claude Code sessions for recurring corrections…
git:20260911.623fe4a · audit A · 3 stars
fresh-eyes SKILL.md skill
adamlinscott/claude-skills · skills/fresh-eyes/SKILL.md · [Adam''s Skills] Fresh-context audit of a finished diff against the conversation''s stated intent. A subagent with zero…
git:20261008.fda8754 · audit A · 3 stars
goal-workflow SKILL.md skill
adamlinscott/claude-skills · skills/goal-workflow/SKILL.md · [Adam''s Skills] DEPRECATED — superseded by /build-it. Do not use for new work. Ran a settled goal as a bounded…
git:20260911.623fe4a · audit A · 3 stars
memory-audit SKILL.md skill
adamlinscott/claude-skills · skills/memory-audit/SKILL.md · [Adam''s Skills] Audit Claude''s per-user memory for this project and produce a report. Asks at the start whether the…
git:20261008.fda8754 · audit A · 3 stars
reground SKILL.md skill
adamlinscott/claude-skills · skills/reground/SKILL.md · [Adam''s Skills] Halt a drifting agent and re-anchor it to codebase evidence for the current task, clearing speculative…
git:20260911.623fe4a · audit A · 3 stars
report-issue SKILL.md skill
adamlinscott/claude-skills · skills/report-issue/SKILL.md · [Adam''s Skills] Alias for the raise-issue skill. Turns "this is broken" into a well-formed issue in the team''s…
git:20261008.fda8754 · audit A · 3 stars

Every file in adamlinscott/claude-skills

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