Agent skill

Verification

by Norman-bury in Norman-bury/research-writing-skill

A skill your agent uses when about to claim work is complete, a chapter is finished, or references are verified - requires running verification commands and confirming output before making any…

MITAuto-check: notes

Install Verification

skills CLI
$ npx skills add Norman-bury/research-writing-skill --skill verification -a claude-code

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

GitHub CLI
$ gh skill install Norman-bury/research-writing-skill verification --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/Norman-bury/research-writing-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/verification .claude/skills/verification && 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
verification
GitHub stars
3.4k
Token cost
~613 tokens
SKILL.md length
108 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when about to claim work is complete, a chapter is finished, or references are verified - requires running verification commands and confirming output before making any…

  • About to claim work is complete
  • SKILL.md covers 核心原则, 验证门控, 常见验证场景 and Red Flags - 停止, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • A chapter is finished

What it does

Verification is an agent skill from Norman-bury/research-writing-skill. Use when about to claim work is complete, a chapter is finished, or references are verified - requires running verification commands and confirming output before making any success claims

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: 科研写作助手 (Research Writing Assistant). The licence is MIT.

When your agent uses it

  • About to claim work is complete
  • A chapter is finished
  • References are verified - requires running verification commands and confirming output before making any success claims

Example prompts

  • “/verification”

Requirements

  • Pre-approved tools (allowed-tools): Read, Bash, Grep

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are powershell).

    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

Verification loads about 613 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 108 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~613

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash, Grep

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Norman-bury/research-writing-skill at commit 6f79595, republished under its MIT licence (© Norman-bury). 108 words, ~613 tokens.

Download SKILL.mdSave it as .claude/skills/verification/SKILL.md (or your agent's skills folder).
name
verification
description
Use when about to claim work is complete, a chapter is finished, or references are verified - requires running verification commands and confirming output before making any success claims
allowed-tools
Read, Bash, Grep

验证机制

核心原则

声称完成而没有验证,是不诚实的表现。

没有验证证据,就不能声称完成

验证门控

在声称任何状态或表达满意之前:

1. 确认:什么命令/操作能证明这个声称?
2. 执行:运行完整的验证操作
3. 读取:完整输出,检查结果
4. 验证:输出是否确认声称?
   - 如果否:说明实际状态和证据
   - 如果是:说明声称和证据
5. 然后才能:做出声称

跳过任何步骤 = 撒谎,不是验证

常见验证场景

声称需要的验证不充分
章节完成字数统计、结构检查、文件存在"应该写完了"
引用真实DOI 可访问、CrossRef API 确认"看起来像真的"
论点有支撑evidence map 中有段落级证据"这段写得像论文"
格式正确运行格式检查脚本目测检查
无AI痕迹运行风格检查脚本"读起来还行"
文献搜索完成结果数量、DOI 列表、JSON 文件存在"搜过了"
skill 改造完成运行 scripts/check_skill_integrity.ps1"文件都写了"
初稿达到质量门运行 scripts/research_quality_gate.ps1只运行 style_check

Red Flags - 停止

出现以下情况时,必须先验证:

  • 使用"应该"、"可能"、"看起来"
  • 在验证前表达满意("好了!"、"完成!")
  • 准备提交/推送/合并而不验证
  • 相信代理的成功报告
  • 依赖部分验证
  • 想着"就这一次"
  • 疲劳想结束工作
  • 任何暗示成功但没有运行验证的措辞

借口与事实

借口事实
"应该行了"运行验证命令
"我很确信"确信 ≠ 证据
"就这一次"没有例外
"格式检查过了"格式检查 ≠ 内容正确
"代理说成功了"独立验证
"我累了"疲劳不是借口
"部分检查够了"部分证明不了什么

关键验证模式

章节完成验证
✅ [运行字数统计] [看到:3000字] "章节字数达标"
✅ [检查文件存在] [看到:chapters/01-introduction.md 存在] "章节文件已创建"
✅ [运行格式检查] [看到:0 errors] "格式正确"
❌ "应该写完了" / "看起来完整"
引用验证
✅ [调用 CrossRef API] [看到:DOI 存在,信息匹配] "引用已验证"
✅ [搜索原始来源] [找到:作者、期刊、年份一致] "引用真实"
❌ "引用看起来正确" / "应该是真的"
论点支撑验证
✅ [检查 evidence-map] [看到:每个 gap claim 对应 2 条来源] "研究空白有文献支撑"
✅ [检查 citation slot] [看到:段落 P2 使用 FL-05 + FL-07] "引用位置明确"
❌ "相关工作看起来完整" / "这段有学术感"
Skill 完整性验证
powershell
powershell -ExecutionPolicy Bypass -File scripts/check_skill_integrity.ps1

用于确认新增技能、路由、验证脚本和关键门控仍然存在。

稿件质量门验证
powershell
powershell -ExecutionPolicy Bypass -File scripts/research_quality_gate.ps1 -ProjectPath <paper-project>

用于检查引用覆盖、正文污染、列表化、占位策略、figure data manifest 和 evidence map。投稿前加 -Submission,禁止未回填占位。

文献搜索验证
✅ [检查 JSON 文件] [看到:20 条结果,每条有 DOI] "搜索完成"
✅ [验证 BibTeX 输出] [看到:可解析,无错误] "BibTeX 有效"
❌ "搜过了" / "应该有结果"

验证检查清单

每项工作完成前必须验证:

  • 运行了验证命令
  • 读取了完整输出
  • 确认结果支持声称
  • 没有依赖"应该"或"可能"
  • 证据在当前消息中呈现

为什么这很重要

从实际失败案例中:

  • 引用伪造导致论文撤稿
  • 章节字数不达标导致返工
  • 格式错误导致投稿失败
  • AI 痕迹明显导致评审质疑

底线

验证没有捷径。

运行命令。读取输出。然后才能声称结果。

这是不可协商的。

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

Files

Just SKILL.md in skills/verification of Norman-bury/research-writing-skill.

Open the folder on GitHubat commit 6f79595

Compare with similar skills

Verification 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.

Verification compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Verification this skillNorman-bury/research-writing-skill3.4k—~613Automated safety check: NotesMIT
Claimsruvnet/ruflo74k2 repos~1.1kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Dos Verify Done Claimssickn33/agentic-awesome-skills47k1 repos~2.1kAutomated safety check: PassMIT
Claim Chartanthropics/claude-for-legal9.6k2 repos~10kAutomated safety check: PassApache-2.0
Paper Claim Auditwanshuiyin/Auto-claude-code-research-in-sleep17k1 repos~3.5kAutomated safety check: NotesMIT

Similar skills

  • Claims

    ruvnet/ruflo

    Claims-based authorization for agents and operations. An agent skill from ruvnet/ruflo.

    74k GitHub starsUsed in 2 repos~1.1k tokens
    Backend & APIsAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Dos Verify Done Claims

    sickn33/agentic-awesome-skills

    Before accepting an agent's 'done / shipped / fixed' claim, verify it against ground truth (git ancestry + the commit's own diff) using the DOS kernel's dos verify and dos commit-audit — never the…

    47k GitHub starsUsed in 1 repo~2.1k tokens
    Media & CreativeAuto-check passed
  • Claim Chart

    anthropics/claude-for-legal

    Official

    Build or review an element chart — a patent claim chart (infringement, invalidity, or review) or a civil element chart for any cause of action or defense — with every cell pin-cited and gap…

    9.6k GitHub starsUsed in 2 repos~10k tokens
    Legal & ComplianceAuto-check passed
  • Paper Claim Audit

    wanshuiyin/Auto-claude-code-research-in-sleep

    Zero-context verification that every number, comparison, and scope claim in the paper matches raw result files.

    17k GitHub starsUsed in 1 repo~3.5k tokens
    Auto-check: notes
  • Result To Claim

    brycewang-stanford/Auto-Empirical-Research-Skills

    A skill your agent uses when experiments complete to judge what claims the results support, what they do not, and what evidence is still missing.

    4.6k GitHub stars~1.3k tokensUpdated 5 days ago
    Auto-check: notes

More from Norman-bury/research-writing-skill

All 20 skills in this repo
  • Evidence Driven Writing

    Norman-bury/research-writing-skill

    A skill your agent uses when writing or revising Introduction, Related Work, background, literature synthesis, or any section where references must drive claims

    3.4k GitHub stars~952 tokensUpdated 4 mo ago
    Auto-check passed
  • Environment Setup

    Norman-bury/research-writing-skill

    A skill your agent uses when Python environment setup is needed for data visualization or conda installation is required

    3.4k GitHub stars~840 tokensUpdated 4 mo ago
    Auto-check passed
  • Experiment Results Planning

    Norman-bury/research-writing-skill

    A skill your agent uses when designing experiments, result tables, mock planning data, evaluation protocols, or results sections before real data are final

    3.4k GitHub stars~990 tokensUpdated 4 mo ago
    Auto-check passed
  • Figures Diagram

    Norman-bury/research-writing-skill

    A skill your agent uses when creating flowcharts, architecture diagrams, or conceptual diagrams - generates prompts for image AI

    3.4k GitHub stars~548 tokensUpdated 4 mo ago
    Auto-check passed
  • Figures Python

    Norman-bury/research-writing-skill

    A skill your agent uses when creating data visualizations for papers - generates publication-quality plots with top-journal color schemes

    3.4k GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Latex Output

    Norman-bury/research-writing-skill

    A skill your agent uses when user requests LaTeX format output or has provided school/journal LaTeX templates

    3.4k GitHub stars~977 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Verification

What does Verification do?

A skill your agent uses when about to claim work is complete, a chapter is finished, or references are verified - requires running verification commands and confirming output before making any…. Verification is an agent skill from Norman-bury/research-writing-skill.

When should I use Verification?

Verification fits situations like: about to claim work is complete; A chapter is finished; references are verified - requires running verification commands and confirming output before making any success claims.

How do I install Verification in Claude Code?

Run `npx skills add Norman-bury/research-writing-skill --skill verification -a claude-code`. Or copy the skill folder (skills/verification in Norman-bury/research-writing-skill) into .claude/skills/verification in your project. Claude Code loads it when a task matches its description.

How do I install Verification in Codex?

Run `npx skills add Norman-bury/research-writing-skill --skill verification -a codex`. Or copy the skill folder (skills/verification in Norman-bury/research-writing-skill) into .agents/skills/verification in your project. Codex loads it when a task matches its description.

Can I use Verification 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 Norman-bury/research-writing-skill --skill verification -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/verification, .gemini/skills/verification, .github/skills/verification and .opencode/skills/verification in your project.

What does Verification need to run?

SKILL.md names no scripts, command-line tools or credentials: Verification is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Bash, Grep.

Does Verification 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 Verification safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Verification use?

Verification 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 Verification use?

About 613 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Verification?

Skills that share tags, products or a category with Verification: Claims (ruvnet/ruflo, 74k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Dos Verify Done Claims (sickn33/agentic-awesome-skills, 47k stars) and Claim Chart (anthropics/claude-for-legal, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Verification?

Norman-bury (a GitHub user) maintains it in Norman-bury/research-writing-skill, which has 3,384 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on June 10, 2026.

Source: Norman-bury/research-writing-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.