Files an issue on the Nerviz repository from inside a generated project, from a free description or from a lessons-learned file under `docs/lessons-learned/`. Picks the repository's own issue form, refuses a report with no evidence a maintainer can verify, warns when the project is behind the latest release, searches open duplicates, strips everything that identifies this project, and publishes only after an explicit confirmation. Explicit invocation only.
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
# Report Issue
The single door from a generated project to the Nerviz repository. A
defect in a template, a norm or a hook shows up here first, but its fix belongs upstream:
fixing it in this project fixes one project, fixing the owner fixes every project generated
afterwards. This skill writes the report so that the owner can act on it — and so that the
maintainer, who verifies every claim before accepting it, can find each one.
**Entry rule: only the user files.** Nothing chains this skill. `/sonar-lessons` ends by
printing the command that runs it; the user types it or doesn't.
**Evidence rule: a report nobody can verify is not filed.** The meta-repository triages every
issue skeptically — each claim is checked against its own code before anything changes. A
claim with no file, no output and no way to reproduce it can only be closed as
*needs evidence*, so this skill asks for what's missing before it writes anything.
**Privacy rule: the issue carries the trace, never the project.** The Nerviz
repository is public and this project may not be. The body names Sonar rule keys, counts,
paths **inside `.claude/`**, commands and hook output only — never a path under `src/`, a
…
The line at the top of this page pins the label git:20261005.8c5a396, 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.
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 (11731 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
nerviz-ai/nerviz · 8 stars · license MIT · pushed 2026-10-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_vqkuj6wyfjnnvfki
GET https://markdownregistry.com/api/v1/resolve?ref=nerviz-ai/nerviz/report-issue
GET https://markdownregistry.com/api/v1/blob/7a8938c5b500b0094fab39518c9eb56426585ad467c3b1e8f6d29d581e5e5544
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.
nerviz-ai/nerviz · .claude/skills/ai-architect/SKILL.md · Designs the outbound AI ports of an already-scoped use case — a language model asked for a structured answer (classify…
nerviz-ai/nerviz · .claude/skills/arch-adopt/SKILL.md · Installs or updates this architecture's `.claude/` inside a Java project — norms with their globs derived for the…
nerviz-ai/nerviz · .claude/skills/arch-doctor/SKILL.md · Diagnoses the AI setup and architecture enforcement on this machine: active hooks, loaded boundary rules, build…
nerviz-ai/nerviz · .claude/skills/audit-usage/SKILL.md · Reads the execution trail the `audit` hook writes into `.claude/audit-usage/` and consolidates it across runs —…
nerviz-ai/nerviz · .claude/skills/cache-architect/SKILL.md · Designs the application cache of an already-scoped use case — which reads are served from a copy, the key of each…
nerviz-ai/nerviz · .claude/skills/docker-architect/SKILL.md · Extends a project's docker-compose.yml and Dockerfile after project-bootstrap's base generation — adds the database or…
nerviz-ai/nerviz · .claude/skills/domain-modeling/SKILL.md · Details the domain and application layer of an already-designed use case — aggregate, value objects, invariants, ports…
nerviz-ai/nerviz · .claude/skills/git-publish/SKILL.md · Offers to git init/commit the current project and, optionally, create a GitHub repo (via `gh`) and push — always behind…
nerviz-ai/nerviz · .claude/skills/gof-design-patterns/SKILL.md · Chooses and implements a design pattern in Java/Spring from the symptom that justifies it. Use when the request…
nerviz-ai/nerviz · .claude/skills/graphql-api-architect/SKILL.md · Designs the inbound GraphQL adapter of an already-modeled use case — schema-first, Spring for GraphQL on the servlet…
nerviz-ai/nerviz · .claude/skills/http-client-architect/SKILL.md · Designs the outbound HTTP adapter of an already-modeled use case — which client (HTTP interface with @HttpExchange over…
microsoft/power-platform-skills · plugins/model-apps/skills/report-issue/SKILL.md · Use this skill when the user wants to "report a bug", "file an issue", "report an issue", "submit a bug report", or…
microsoft/power-platform-skills · plugins/power-pages/skills/report-issue/SKILL.md · Use this skill when the user wants to "report a bug", "file an issue", "report an issue", "submit a bug report", or…
microsoft/power-platform-skills · plugins/code-apps/skills/report-issue/SKILL.md · Use this skill when the user wants to "report a bug", "file an issue", "report an issue", "submit a bug report", or…
microsoft/power-platform-skills · plugins/pcf/skills/report-issue/SKILL.md · Use this skill when the user wants to "report a bug", "file an issue", "report an issue", "submit a bug report", or…
microsoft/power-platform-skills · plugins/power-automate/skills/report-issue/SKILL.md · Use this skill when the user wants to "report a bug", "file an issue", "report an issue", "submit a bug report", or…
microsoft/power-platform-skills · plugins/mobile-apps/skills/report-issue/SKILL.md · Use when the user wants to report a bug, file an issue, submit a bug report, or report any problem with the mobile-app…
microsoft/power-platform-skills · plugins/canvas-apps/skills/report-issue/SKILL.md · Use this skill when the user wants to "report a bug", "file an issue", "report an issue", "submit a bug report", or…
microsoft/power-platform-skills · plugins/mcp-apps/skills/report-issue/SKILL.md · Use this skill when the user wants to "report a bug", "file an issue", "report an issue", "submit a bug report", or…
