Agent skill

Defect Intake and RCA Candidates

by protect-my-hair in protect-my-hair/nucleus-marketplace

Checks whether a defect report has enough context to be accepted, then drafts candidate-only root-cause evidence for human review without confirming causes or changing code.

MITAuto-check passedTesting & QA

SKILL.md written in Chinese; this summary is our English description.

Install Defect Intake and RCA Candidates

skills CLI
$ npx skills add protect-my-hair/nucleus-marketplace --skill defect-intake-rca -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install protect-my-hair/nucleus-marketplace defect-intake-rca --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/protect-my-hair/nucleus-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/nucleus/skills/defect-intake-rca .claude/skills/defect-intake-rca && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
defect-intake-rca
GitHub stars
164
Token cost
~745 tokens
SKILL.md length
211 words
Files
13 (incl. scripts, references, assets)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Checks whether a defect report has enough context to be accepted, then drafts candidate-only root-cause evidence for human review without confirming causes or changing code.

  • Works in 8 steps: 读取缺陷上下文:读取 .nucleus/context/.json、defect… → 创建宿主任务包:把本 checklist 同步成当前会话的宿主… → 校验受理质量:检查… → …
  • Assessing whether a defect report has enough context to be accepted
  • SKILL.md covers 核心原则, Checklist, Runtime and 必需输入, plus 1 more section
  • Runs Python scripts from its folder; calls python3

What it does

Part of the Nucleus V2 plugin for coding agents, the skill reads a context file for the workflow run and assesses defect intake quality. It requires a defect ID, a stage of intake-quality or rca, structured reproduction evidence, at least one log or failing test report and exactly one primary feature document under docs/features. It then drafts a root-cause candidate with a review checklist.

Firm gates apply. The agent first creates a task list in the host, never drafts a candidate while key context is missing, and may write only inside the run's defects folder under .nucleus. A candidate is never a confirmed root cause, a fix, a passing test or a closed defect, and a subagent pre-review must clear the material before a human RCA review is requested. A bundled Python script runs the analysis, with JSON and Markdown templates and a schema for the candidate.

When your agent uses it

  • Assessing whether a defect report has enough context to be accepted
  • Drafting root-cause candidates for a human RCA review
  • Finding which reproduction, log or feature-doc inputs are still missing

Example prompts

  • “Assess the intake quality of this defect from its Nucleus context file and list what is missing.”
  • “Generate an RCA candidate for the defect in the current workflow run and mark what still needs review.”
  • “Which inputs are missing before this defect can go to RCA review?”

Requirements

  • Python 3
  • A Nucleus workflow context file for the defect run
  • A primary feature document under docs/features

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. 读取缺陷上下文:读取 .nucleus/context/.json、defect context artifacts 和 primary feature doc;缺关键输入时 ALERT_AND_BLOCK。
  2. 创建宿主任务包:把本 checklist 同步成当前会话的宿主 todo/task;未同步前不得生成 intake quality 或 RCA candidate。
  3. 校验受理质量:检查 defectId、stage、复现、日志或失败测试、session binding 和写入边界。
  4. 补齐缺陷信息:缺少关键上下文时,只呈现缺口并提出当前最关键补齐问题,按 references/defect-info-request-format.md 组织提问;没有明确补齐事实时 STOP。
  5. 生成 intake quality 证据:只写 .nucleus/runs//defects/intake-quality.*,不得写源码、测试、PR/MR 或缺陷状态。
  6. 生成 RCA candidate:基于已验证上下文生成根因候选和 review checklist;candidate 仍是待审证据。
  7. 等待 RCA review:向用户或 PMS 呈现候选、非事实和待确认项;缺人工 review 时 STOP。
  8. 写入结果证据:构建 result package;NEEDS_HUMAN_REVIEW 不代表根因确认、修复完成、测试通过或缺陷可关闭。

What it can do on your machine

Read from SKILL.md and the folder at commit 3c82085. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Defect Intake and RCA Candidates loads about 745 tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 24 tokens; SKILL.md has 211 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~745
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from protect-my-hair/nucleus-marketplace at commit 3c82085, republished under its MIT licence (© protect-my-hair). 211 words, ~745 tokens.

Download SKILL.mdSave it as .claude/skills/defect-intake-rca/SKILL.md (or your agent's skills folder). This skill also uses 12 other files; get the full folder from GitHub.
name
defect-intake-rca
description
Use when 从显式缺陷 context package 评估 Nucleus V2 缺陷接入质量并生成 candidate-only RCA 证据。

Defect Intake RCA

前置:使用本 Skill 前,先按 using-nucleus 完成 Nucleus 入口识别(Claude Code 会话由插件 SessionStart hook 自动注入该纪律)。

用于 Nucleus V2 缺陷受理 workflow 基线:在 Claude Code / Codex 内做缺陷受理质量评估和 RCA 候选证据生成。这是 coding-agent 插件运行时,不是 PMS 后端 workflow。

核心原则

缺陷受理和 RCA 只能生成可审查的质量评估与根因候选证据;它不能确认根因、修复代码、验证回归、关闭缺陷、创建 PR/MR 或推进 PMS 状态。

<HARD-GATE>
未创建宿主 todo/task 任务包,不得运行 `analyze` 或进入 result package。

缺少 defectId、stage、结构化复现、log / failing test / failed test report、primary feature 或 feature doc 时,不得生成 RCA candidate,必须先补齐缺陷上下文。

RCA candidate、review checklist、summary 或 result 不能替代人工 RCA review、根因确认、修复完成、测试通过或缺陷关闭事实。

到达 rca-review 人审点时,按 _shared/references/subagent-precheck-protocol.md 执行 subagentPreReview 子代理预审;未取得“材料可提交人工审查”结论前,不得请求人工 RCA review。 </HARD-GATE>

Checklist

启动本 Skill 后,必须先为以下每一项创建宿主 todo/task,并按顺序执行;Codex 使用计划 / 任务工具,Claude Code 使用 TodoWrite 或等价宿主 todo。每完成、阻塞、等待人工补齐或等待 review 一项,都必须逐项更新状态;若等待项触达人审点,先完成 subagentPreReview 并确认材料可提交人工审查。

  1. 读取缺陷上下文:读取 .nucleus/context/<workflowRunId>.json、defect context artifacts 和 primary feature doc;缺关键输入时 ALERT_AND_BLOCK。
  2. 创建宿主任务包:把本 checklist 同步成当前会话的宿主 todo/task;未同步前不得生成 intake quality 或 RCA candidate。
  3. 校验受理质量:检查 defectId、stage、复现、日志或失败测试、session binding 和写入边界。
  4. 补齐缺陷信息:缺少关键上下文时,只呈现缺口并提出当前最关键补齐问题,按 references/defect-info-request-format.md 组织提问;没有明确补齐事实时 STOP。
  5. 生成 intake quality 证据:只写 .nucleus/runs/<workflowRunId>/defects/intake-quality.*,不得写源码、测试、PR/MR 或缺陷状态。
  6. 生成 RCA candidate:基于已验证上下文生成根因候选和 review checklist;candidate 仍是待审证据。
  7. 等待 RCA review:向用户或 PMS 呈现候选、非事实和待确认项;缺人工 review 时 STOP。
  8. 写入结果证据:构建 result package;NEEDS_HUMAN_REVIEW 不代表根因确认、修复完成、测试通过或缺陷可关闭。

Runtime

bash
python3 skills/defect-intake-rca/scripts/defect_intake_rca.py analyze \
  --repo-root <target-repo> \
  --context <target-repo>/.nucleus/context/<workflowRunId>.json

仅校验器使用的可选参数:

bash
--candidate-output <target-repo>/.nucleus/runs/<workflowRunId>/defects/rca-candidate.json

必需输入

  • 读取 .nucleus/context/<workflowRunId>.json。
  • 要求 workflow.workflowId=defect-intake-rca。
  • 要求 defect.defectId、defect.stage 和 defect.dir。
  • 要求 defect.stage 为 intake-quality 或 rca。
  • 要求结构化 context.inputArtifacts[] 包含复现证据,以及至少一个 log、failing test 或 failed test report。
  • defect.contextArtifacts[] 只作为补充只读路径处理。
  • 要求恰好一个 primary feature,featurePath=docs/features/**/feature.md,且该 feature doc 必须存在。

写入边界

只写:

  • .nucleus/runs/<workflowRunId>/defects/**
  • .nucleus/runs/<workflowRunId>/result.json

绝不写 docs/requirement/**、docs/features/**、tests/**、.nucleus/tests/**、源码、PR/MR 状态、commit、branch 或缺陷状态。

NEEDS_HUMAN_REVIEW 表示已生成待审候选。它不代表根因已确认、代码已修复、测试已通过或缺陷可关闭。

FAILED_BLOCKED 表示需要人工修复 context、artifacts、写入策略或 session binding 要求后重跑本 workflow。

不得导入根目录 harness/;运行时依赖必须打包在本 Skill 或 skills/_shared/nucleus_runtime/** 下。

© protect-my-hair, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 12 other files (scripts, references, assets) in plugins/nucleus/skills/defect-intake-rca of protect-my-hair/nucleus-marketplace.

  • SKILL.md
  • agents/openai.yaml
  • assets/defect-rca-candidate-template.json
  • assets/defect-rca-candidate-template.md
  • assets/intake-quality-template.json
  • assets/intake-quality-template.md
  • assets/nucleus-defect-rca-candidate.schema.json
  • references/blocker-matrix.md
  • references/candidate-schema.md
  • references/defect-boundary.md
  • references/defect-info-request-format.md
  • references/session-binding-boundary.md
  • scripts/defect_intake_rca.py

Open the folder on GitHubat commit 3c82085

Compare with similar skills

Defect Intake and RCA Candidates next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Defect Intake and RCA Candidates compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Defect Intake and RCA Candidates this skillprotect-my-hair/nucleus-marketplace164—~745Automated safety check: PassMIT
Issue Trackingstatic-web-server/static-web-server2.4k—~1.5kAutomated safety check: PassApache-2.0
Bug ReproducerAnastasiyaW/codex-claude-code-config154—~4.1kAutomated safety check: PassMIT
Diagnoseipea/geobr961—~1.5kAutomated safety check: PassNone
Supporthomebridge-plugins/homebridge-eufy224—~1.7kAutomated safety check: PassApache-2.0
Investigate BugBuilderIO/agent-native7.1k—~1kAutomated safety check: PassNone

Similar skills

  • Issue Tracking

    static-web-server/static-web-server

    Triage, reproduce, debug, and fix issues in the Static Web Server (SWS) project — bug reports, regressions, root-cause analysis, minimal fixes with regression tests, v2 backports, and security…

    2.4k GitHub stars~1.5k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Bug Reproducer

    AnastasiyaW/codex-claude-code-config

    Find likely software bugs in a codebase, rank concrete bug candidates, and prove or reject them with focused regression tests before proposing a fix.

    154 GitHub stars~4.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Diagnose

    ipea/geobr

    Root-cause a failing or wrong geobr call with a disciplined check-the-environment-first loop instead of guessing.

    961 GitHub stars~1.5k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Support

    homebridge-plugins/homebridge-eufy

    Triage a GitHub issue using diagnostics archives and logs. An agent skill from homebridge-plugins/homebridge-eufy.

    224 GitHub stars~1.7k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Investigate Bug

    BuilderIO/agent-native

    Given a bug report (GitHub issue, Jira ticket, file, or pasted text), find its root cause and decide per symptom whether it is a one-off or one instance of a pattern worth fixing at the root, then…

    7.1k GitHub stars~1k tokensUpdated today
    Testing & QAAuto-check passed
  • AI Bug Triage

    petrkindlmann/qa-skills

    Hybrid fingerprint + LLM pipeline for bug classification, deduplication, and ticket generation.

    170 GitHub stars~5.2k tokensUpdated 4 mo ago
    Testing & QAAuto-check passed

More from protect-my-hair/nucleus-marketplace

All 18 skills in this repo
  • Nucleus Delivery Evidence Closure

    protect-my-hair/nucleus-marketplace

    Collects prior Nucleus task evidence into a candidate-only delivery closure package and PR/MR draft text, blocking if any feature's design, review or verification evidence is missing.

    164 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Context Validator

    protect-my-hair/nucleus-marketplace

    Validates the context file for a Nucleus V2 workflow run, discovers standalone context from explicit input, and writes a blocked result when required context is missing.

    164 GitHub stars~576 tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Session Binding Report

    protect-my-hair/nucleus-marketplace

    Collects, freezes and validates a Nucleus V2 session binding report that records the native Claude Code or Codex session ID, transcript path and hash.

    164 GitHub stars~477 tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Result Package Builder

    protect-my-hair/nucleus-marketplace

    Builds the result.json file for a Nucleus V2 workflow run from its context, gates, blockers and step status, and exits non-zero when the run is blocked.

    164 GitHub stars~414 tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Delivery Evidence Finalizer

    protect-my-hair/nucleus-marketplace

    Combines the evidence from completed Nucleus workflow steps into a final evidence report and result package, without scheduling steps, updating trackers or opening pull requests.

    164 GitHub stars~454 tokensUpdated 2 mo ago
    Auto-check passed
  • Feature Doc Design

    protect-my-hair/nucleus-marketplace

    A skill your agent uses when 特性开发需要直接在产品仓库 docs/features 下写可评审的特性文档和邻近设计文档。

    164 GitHub stars~895 tokensUpdated 2 mo ago
    Auto-check passed

Questions about Defect Intake and RCA Candidates

What does Defect Intake and RCA Candidates do?

Checks whether a defect report has enough context to be accepted, then drafts candidate-only root-cause evidence for human review without confirming causes or changing code. Part of the Nucleus V2 plugin for coding agents, the skill reads a context file for the workflow run and assesses defect intake quality. It requires a defect ID, a stage of intake-quality or rca, structured reproduction evidence, at least one log or failing test report and exactly one primary feature document under docs/features.

When should I use Defect Intake and RCA Candidates?

Defect Intake and RCA Candidates fits situations like: assessing whether a defect report has enough context to be accepted; drafting root-cause candidates for a human RCA review; finding which reproduction, log or feature-doc inputs are still missing.

How do I install Defect Intake and RCA Candidates in Claude Code?

Run `npx skills add protect-my-hair/nucleus-marketplace --skill defect-intake-rca -a claude-code`. Or copy the skill folder (plugins/nucleus/skills/defect-intake-rca in protect-my-hair/nucleus-marketplace) into .claude/skills/defect-intake-rca in your project. Claude Code loads it when a task matches its description.

How do I install Defect Intake and RCA Candidates in Codex?

Run `npx skills add protect-my-hair/nucleus-marketplace --skill defect-intake-rca -a codex`. Or copy the skill folder (plugins/nucleus/skills/defect-intake-rca in protect-my-hair/nucleus-marketplace) into .agents/skills/defect-intake-rca in your project. Codex loads it when a task matches its description.

Can I use Defect Intake and RCA Candidates in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add protect-my-hair/nucleus-marketplace --skill defect-intake-rca -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/defect-intake-rca, .gemini/skills/defect-intake-rca, .github/skills/defect-intake-rca and .opencode/skills/defect-intake-rca in your project.

What does Defect Intake and RCA Candidates need to run?

Going by SKILL.md and its folder, Defect Intake and RCA Candidates needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3; A Nucleus workflow context file for the defect run; A primary feature document under docs/features.

Does Defect Intake and RCA Candidates access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Defect Intake and RCA Candidates safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Defect Intake and RCA Candidates use?

Defect Intake and RCA Candidates is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Defect Intake and RCA Candidates use?

About 745 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1k tokens, read only when the agent opens those files.

What are the alternatives to Defect Intake and RCA Candidates?

Skills that share tags, products or a category with Defect Intake and RCA Candidates: Issue Tracking (static-web-server/static-web-server, 2.4k stars), Bug Reproducer (AnastasiyaW/codex-claude-code-config, 154 stars), Diagnose (ipea/geobr, 961 stars) and Support (homebridge-plugins/homebridge-eufy, 224 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Defect Intake and RCA Candidates?

protect-my-hair (a GitHub user) maintains it in protect-my-hair/nucleus-marketplace, which has 164 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on July 23, 2026.

Source: protect-my-hair/nucleus-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.