Agent skill

Knowledge Index Verify

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

Verify docs/features feature frontmatter, test attribution, docIndexLinks, code-facts tool evidence, and produce a candidate knowledge index under .nucleus/runs only.

MITAuto-check passed

Install Knowledge Index Verify

skills CLI
$ npx skills add protect-my-hair/nucleus-marketplace --skill knowledge-index-verify -a claude-code

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

GitHub CLI
$ gh skill install protect-my-hair/nucleus-marketplace knowledge-index-verify --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/knowledge-index-verify .claude/skills/knowledge-index-verify && 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
knowledge-index-verify
GitHub stars
164
Token cost
~512 tokens
SKILL.md length
94 words
Files
12 (incl. scripts, references, assets)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Verify docs/features feature frontmatter, test attribution, docIndexLinks, code-facts tool evidence, and produce a candidate knowledge index under .nucleus/runs only.

  • SKILL.md covers 边界, 使用, Code Facts Strict and 人审前子代理预审, plus 1 more section
  • Runs Python scripts from its folder; calls python3

What it does

Knowledge Index Verify is an agent skill from protect-my-hair/nucleus-marketplace. Verify docs/features feature frontmatter, test attribution, docIndexLinks, code-facts tool evidence, and produce a candidate knowledge index under .nucleus/runs only.

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. The skill folder holds 15 other files, including scripts, reference files and assets (for example `agents/openai.yaml`, `assets/candidate-knowledge-index-template.json` and `assets/nucleus-code-facts-evidence.schema.json`).

The repository describes itself as: Nucleus — Claude Code / Codex 工作流插件,确保 AI 编码产出结构可信、边界可审计、过程可追溯. The licence is MIT.

Example prompts

  • “/knowledge-index-verify”

Requirements

  • Python 3

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

Knowledge Index Verify loads about 512 tokens when it runs, and up to ~1.2k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 94 words of instructions outside code blocks.

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

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). 94 words, ~512 tokens.

Download SKILL.mdSave it as .claude/skills/knowledge-index-verify/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
knowledge-index-verify
description
Verify docs/features feature frontmatter, test attribution, docIndexLinks, code-facts tool evidence, and produce a candidate knowledge index under .nucleus/runs only.

knowledge-index-verify

本 Skill 是 Nucleus V2 Knowledge Index / llm-wiki approved-write 的只读 verify gate。它只生成 candidate、diff、report 和 result package,不同步生产索引。

边界

  • 不覆盖 docs/knowledge-index.json。
  • 不生成、更新或补写 docs/features/**/code-facts.md。
  • 不从 LLM prompt、人工摘要或检索结果直接推断代码事实。
  • 不写 docs/requirement/**、docs/features/**、tests/**、.nucleus/tests/** 或源码。
  • Runtime 只允许写 .nucleus/runs/<workflowRunId>/knowledge/** 与 .nucleus/runs/<workflowRunId>/result.json。
  • 失败默认 ALERT_AND_BLOCK,不得静默降级。

使用

bash
python3 skills/knowledge-index-verify/scripts/knowledge_index_verify.py verify \
  --repo-root /path/to/target-repo \
  --context /path/to/target-repo/.nucleus/context/<workflowRunId>.json \
  --tool-evidence /path/to/target-repo/.nucleus/runs/<workflowRunId>/knowledge/tool-evidence/gitnexus-search-report.json

--tool-evidence 必须是显式 adapter evidence JSON。GitNexus、Serena、Yog 或 static analyzer readiness 只能来自该 evidence、capabilityStatus 或工具注册报告,不能凭宿主环境猜测。

Code Facts Strict

当以下任一条件成立时,code-facts 证据缺失必须 FAILED_BLOCKED:

  • docIndexLinks 引用 docs/features/**/code-facts.md。
  • scanner 发现同 feature 目录下存在 code-facts.md。
  • context 明确要求 code facts。

没有 code-facts 的普通 feature 只能进入 candidate-only 与人工 review,不能生成 prompt-only facts。

人审前子代理预审

到达 candidate-index-review 前,必须按 workflow 的 subagentPreReview 调度独立 reviewer 子代理;未取得“材料可提交人工审查”预审结论时,不得请求人工评审通过。

输出

  • .nucleus/runs/<workflowRunId>/knowledge/feature-scan-report.json
  • .nucleus/runs/<workflowRunId>/knowledge/candidate-knowledge-index.json
  • .nucleus/runs/<workflowRunId>/knowledge/index-diff.md
  • .nucleus/runs/<workflowRunId>/knowledge/verify-report.json
  • .nucleus/runs/<workflowRunId>/knowledge/verify-report.md
  • .nucleus/runs/<workflowRunId>/knowledge/blockers.json
  • .nucleus/runs/<workflowRunId>/result.json

© 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 11 other files (scripts, references, assets) in plugins/nucleus/skills/knowledge-index-verify of protect-my-hair/nucleus-marketplace.

  • SKILL.md
  • agents/openai.yaml
  • assets/candidate-knowledge-index-template.json
  • assets/nucleus-code-facts-evidence.schema.json
  • assets/nucleus-knowledge-index-candidate.schema.json
  • assets/nucleus-knowledge-verify-report.schema.json
  • assets/verify-report-template.md
  • references/blocker-matrix.md
  • references/code-facts-evidence.md
  • references/frontmatter-contract.md
  • references/knowledge-boundary.md
  • scripts/knowledge_index_verify.py

Open the folder on GitHubat commit 3c82085

Compare with similar skills

Knowledge Index Verify 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.

Knowledge Index Verify compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Knowledge Index Verify this skillprotect-my-hair/nucleus-marketplace164—~512Automated safety check: PassMIT
Indexabilitythedaviddias/Front-End-Checklist74k—~814Automated safety check: PassMIT
Indexability Conflictsthedaviddias/Front-End-Checklist74k—~876Automated safety check: PassMIT
Index Refreshpaperclipai/paperclip100k—~994Automated safety check: PassMIT
Adr Indexruvnet/ruflo74k—~861Automated safety check: NotesMIT
Performance AttributionHKUDS/Vibe-Trading35k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Indexability

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site for accidental noindex directives, investigating why important pages are not appearing in Google Search, or reviewing CMS settings that control indexing…

    74k GitHub stars~814 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Indexability Conflicts

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site for indexability issues, investigating why pages appear in Google's index that should be excluded (or vice versa), or reviewing robots.txt and meta…

    74k GitHub stars~876 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Index Refresh

    paperclipai/paperclip

    A skill your agent uses when an LLM Wiki operation issue requests an index refresh.

    100k GitHub stars~994 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Adr Index

    ruvnet/ruflo

    Build or rebuild the ADR index + dependency graph by running scripts/import.mjs (handles v3-style and plugin-style ADR formats; one Bash call vs hundreds of MCP round-trips)

    74k GitHub stars~861 tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Performance Attribution

    HKUDS/Vibe-Trading

    Explains why a portfolio beat or lagged its benchmark with Brinson sector attribution, factor alpha and beta decomposition, timing evaluation and benchmark comparison.

    35k GitHub stars~3.1k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Cuda Index Width

    pytorch/pytorch

    Choose 32-bit vs 64-bit index math in PyTorch CUDA kernels. An agent skill from pytorch/pytorch.

    104k GitHub stars~1.6k tokensUpdated today
    AI & LLM EngineeringAuto-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
  • Defect Intake and RCA Candidates

    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.

    164 GitHub stars~745 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

Questions about Knowledge Index Verify

What does Knowledge Index Verify do?

Verify docs/features feature frontmatter, test attribution, docIndexLinks, code-facts tool evidence, and produce a candidate knowledge index under .nucleus/runs only. Knowledge Index Verify is an agent skill from protect-my-hair/nucleus-marketplace.nucleus/runs only.

How do I install Knowledge Index Verify in Claude Code?

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

How do I install Knowledge Index Verify in Codex?

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

Can I use Knowledge Index Verify 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 knowledge-index-verify -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/knowledge-index-verify, .gemini/skills/knowledge-index-verify, .github/skills/knowledge-index-verify and .opencode/skills/knowledge-index-verify in your project.

What does Knowledge Index Verify need to run?

Going by SKILL.md and its folder, Knowledge Index Verify needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Knowledge Index Verify 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 Knowledge Index Verify 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 Knowledge Index Verify use?

Knowledge Index Verify 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 Knowledge Index Verify use?

About 512 tokens (SKILL.md is roughly 2k 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 710 tokens, read only when the agent opens those files.

What are the alternatives to Knowledge Index Verify?

Skills that share tags, products or a category with Knowledge Index Verify: Indexability (thedaviddias/Front-End-Checklist, 74k stars), Indexability Conflicts (thedaviddias/Front-End-Checklist, 74k stars), Index Refresh (paperclipai/paperclip, 100k stars) and Adr Index (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Knowledge Index Verify?

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.