Agent skill

Verification Engine

by sangrokjung in sangrokjung/claude-forge

A skill your agent uses when verifying build/test/lint before commit, PR, or completion claims.

MITAuto-check passedAgent Workflows

Install Verification Engine

skills CLI
$ npx skills add sangrokjung/claude-forge --skill verification-engine -a claude-code

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

GitHub CLI
$ gh skill install sangrokjung/claude-forge verification-engine --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/sangrokjung/claude-forge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/verification-engine .claude/skills/verification-engine && 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-engine
GitHub stars
850
Token cost
~1.5k tokens
SKILL.md length
491 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when verifying build/test/lint before commit, PR, or completion claims.

  • Verifying build/test/lint before commit
  • SKILL.md covers 검증 원칙, Overview, Trigger Conditions and Architecture (v6), plus 6 more sections
  • Calls eslint
  • Completion claims

What it does

Verification Engine is an agent skill from sangrokjung/claude-forge. Use when verifying build/test/lint before commit, PR, or completion claims. Runs verification pipeline in fresh subagent context with auto-repair. Triggers on /handoff-verify, pre-commit check, build verification, test validation.

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

It sits in Agent Workflows, covering Linting and formatting and Subagents. The repository describes itself as: oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in one install. v4.0 adds an adversarial review loop: a second agent that never sees the first… The licence is MIT.

When your agent uses it

  • Verifying build/test/lint before commit
  • Completion claims
  • /handoff-verify
  • Pre-commit check

Example prompts

  • “/verification-engine”

What it can do on your machine

Read from SKILL.md and the folder at commit 34d881d. 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

    Shell commands in SKILL.md call:

    • eslint

    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 Engine loads about 1.5k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 491 words of instructions outside code blocks.

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

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

SKILL.md

The full file from sangrokjung/claude-forge at commit 34d881d, republished under its MIT licence (© sangrokjung). 491 words, ~1,455 tokens.

Download SKILL.mdSave it as .claude/skills/verification-engine/SKILL.md (or your agent's skills folder).
name
verification-engine
description
Use when verifying build/test/lint before commit, PR, or completion claims. Runs verification pipeline in fresh subagent context with auto-repair. Triggers on /handoff-verify, pre-commit check, build verification, test validation.
version
2.0.0

검증 원칙

Iron Law, Gate Function, Common Failures 체크리스트는 rules/verification.md에 정의되어 있다. 이 스킬은 해당 원칙의 실행 엔진이다.


Overview

통합 검증 엔진 스킬은 /handoff-verify 커맨드의 핵심 동작을 정의한다. v5의 /verify 단독 커맨드에서 v6의 /handoff-verify 통합 커맨드로 진화하였다.

핵심 변경: Task 도구로 verify-agent 서브에이전트를 생성하여 fresh context에서 검증. /clear 없이도 편향 없는 검증이 가능하다.


Trigger Conditions

직접 호출
트리거설명
/handoff-verify핸드오프 + 기본 루프 검증 (최대 5회)
/handoff-verify --once핸드오프 + 단발 검증
/handoff-verify --loop 3핸드오프 + 3회 루프
/handoff-verify --security핸드오프 + 보안 검증 포함
/handoff-verify --coverage핸드오프 + 테스트 커버리지 분석
/handoff-verify --extract핸드오프 + 에러 추출/분류 모드
/handoff-verify --skip-handoff핸드오프 생략 + 검증만
자동 호출
상황동작
/commit-push-pr 실행 전--once 모드로 사전 검증
/orchestrate 검증 단계루프 모드로 자동 실행

Architecture (v6)

/handoff-verify 커맨드 (부모 컨텍스트)
   │
   ├── [1] handoff.md 자동 생성
   │     └── git diff 분석, 변경 의도 문서화
   │
   ├── [2] verify-agent 서브에이전트 생성 (Task 도구)
   │     └── Fresh context! (/clear 대체)
   │         │
   │         ├── handoff.md 읽기
   │         ├── 검증 파이프라인 실행
   │         ├── 실패 시 자동 수정 + 재시도
   │         └── 결과 반환
   │
   └── [3] 결과 수신 및 처리
         ├── PASS → handoff.md 정리, 다음 단계 안내
         └── FAIL → 에러 보고, 권장 조치 안내
v5 대비 아키텍처 변경
v5v6
/handoff → /clear → /verify/handoff-verify (단일 커맨드)
부모 컨텍스트에서 직접 검증서브에이전트가 fresh context에서 검증
/clear로 컨텍스트 손실부모 컨텍스트 보존
수동 3단계 워크플로우자동 1단계 워크플로우

Verification Pipeline

단계별 실행 순서 (verify-agent 내부)
[1단계] 환경 파악
   ├── handoff.md 읽기 (변경 의도)
   ├── git status / diff
   ├── 프로젝트 타입 감지
   └── 패키지 매니저 감지
         │
[2단계] 빌드 검증
   ├── npm run build / go build / cargo build
   └── 빌드 실패 시 → Fixable 자동 수정
         │
[3단계] 타입 검사
   ├── tsc --noEmit / mypy / go vet
   └── 타입 오류 → Fixable 자동 수정
         │
[4단계] 린트 검사
   ├── eslint / golangci-lint / clippy
   └── 린트 오류 → Fixable 자동 수정
         │
[5단계] 테스트 실행
   ├── npm test / go test / cargo test
   └── 실패 시 → 에러 분석 + 수정 시도
         │
[6단계] 코드 리뷰 (effort에 따라)
   ├── low: 건너뜀
   ├── medium: 변경 파일만
   ├── high: 변경 파일 + 의존성
   └── max: 전체 영향 분석
         │
[7단계] 보안 검토 (--security 또는 effort:max)
   └── security-reviewer 서브에이전트 연동
루프 동작 원리
[실행 #1]
   │ FAIL → Fixable 자동 수정 → 재실행
   │
[실행 #2]
   │ FAIL → Fixable 자동 수정 → 재실행
   │
[실행 #3~5]
   │ FAIL → 수정 시도 → 재실행
   │
[5회 실패]
   └── /learn --from-error 제안
       최종 에러 리포트 → 부모에게 반환

Fixable Auto-Repair

자동 수정 가능한 오류 9가지. 서브에이전트가 사용자 승인 없이 즉시 수정한다.

Fixable 목록
#유형감지 패턴수정 방법
1Missing ImportCannot find module, is not defined소스 검색 → import 문 추가
2Unused Importis defined but never usedimport 행 제거
3Lint (auto-fixable)eslint --fix 가능 항목eslint --fix 실행
4Type MismatchType '...' is not assignable타입 캐스팅 또는 인터페이스 수정
5Missing Return TypeMissing return type반환값에서 타입 추론 → 추가
6Formattingprettier / gofmt포매터 실행
7Missing DependencyCould not resolvepackage.json 확인 → 설치 제안
8Enum/Const MismatchExhaustive check 실패누락 케이스 추가
9Test SnapshotSnapshot mismatch스냅샷 업데이트 제안 (승인 필요)
수정 불가 항목 (사용자 판단 필요)
  • 로직 오류 (비즈니스 로직 변경)
  • 아키텍처 변경이 필요한 타입 오류
  • 테스트 로직 자체의 오류
  • 보안 취약점 (security-pipeline이 처리)

Show full SKILL.md (192 more words)Show less

Effort별 동작 차이

effort빌드/타입/린트테스트코드 리뷰보안자동 수정
low실행실행건너뜀건너뜀import/lint만
medium실행실행변경 파일만패턴 매칭만Fixable 전체
high실행실행+ 의존성주요 패턴Fixable + 제안
max실행실행+ 전체 영향security-reviewerFixable + 아키텍처

Coverage Mode (--coverage)

/handoff-verify --coverage 실행 시 테스트 커버리지를 분석한다.

출력 형식
커버리지 리포트
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
전체:      72.3% (목표: 80%)
신규 코드:  45.2%
미커버 파일: 3개
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

미커버 함수:
  src/utils/parser.ts:parseConfig (0%)
  src/api/handler.ts:processRequest (12%)
  src/lib/cache.ts:invalidate (0%)

권장 테스트:
  1. parseConfig - 정상/비정상 입력 테스트
  2. processRequest - 요청/응답 통합 테스트
  3. invalidate - 캐시 무효화 단위 테스트

Extract Mode (--extract)

/handoff-verify --extract 실행 시 에러를 추출하고 분류한다.

분류 체계
카테고리설명예시
BUILD빌드/컴파일 오류Module not found
TYPE타입 시스템 오류Type mismatch
LINT린트/스타일 오류Unexpected any
TEST테스트 실패Expected X, received Y
RUNTIME런타임 오류Cannot read property
SECURITY보안 패턴Hardcoded credential
출력 형식
에러 추출 결과
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
총 에러: 12개
  BUILD:    3개 (Fixable: 2)
  TYPE:     4개 (Fixable: 3)
  LINT:     2개 (Fixable: 2)
  TEST:     2개 (Fixable: 0)
  SECURITY: 1개 (Fixable: 0)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
자동 수정 가능: 7/12 (58%)

Integration Points

/handoff-verify 커맨드

이 스킬은 /handoff-verify 커맨드의 핵심 로직을 정의한다. 커맨드 파일(commands/handoff-verify.md)이 이 스킬의 파이프라인을 실행한다.

verify-agent 에이전트

서브에이전트(agents/verify-agent.md)가 이 스킬의 파이프라인을 실제로 실행한다. 부모 컨텍스트와 분리된 fresh context에서 동작한다.

security-pipeline 스킬

--security 플래그 또는 effort:max 시 security-pipeline 스킬과 연동한다. 보안 검증 부분은 security-pipeline에 위임한다.

/learn 커맨드

5회 루프 실패 시 /learn --from-error를 자동 제안하여 에러 패턴을 CLAUDE.md에 기록한다.

/commit-push-pr 커맨드

커밋 전 사전 검증 게이트로 동작한다:

  • PASS: 모든 검증 통과 → 커밋 진행
  • WARN: 비치명적 이슈 존재 → 경고 후 계속
  • FAIL: 빌드/타입/테스트 실패 → 커밋 차단

© sangrokjung, 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-engine of sangrokjung/claude-forge.

Open the folder on GitHubat commit 34d881d

Compare with similar skills

Verification Engine 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 Engine compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Verification Engine this skillsangrokjung/claude-forge850—~1.5kAutomated safety check: PassMIT
Qwen Agentthananon/9arm-skills3.2k—~1.5kAutomated safety check: PassNone
Bench Batonnooga/let-go568—~821Automated safety check: PassMIT
Cxas Agent FoundryGoogleCloudPlatform/cxas-scrapi107—~2.4kAutomated safety check: PassApache-2.0
Megalinter Setupnvuillam/github-dependents-info162—~3.9kAutomated safety check: NotesMIT
Delegate Verbosetimusus/Shuttle2229—~864Automated safety check: PassApache-2.0

Similar skills

  • Qwen Agent

    thananon/9arm-skills

    Delegate menial, well-scoped coding tasks to a cheap Qwen-backed subagent via the claude-9arm command instead of burning Claude tokens/quota.

    3.2k GitHub stars~1.5k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Bench Baton

    nooga/let-go

    Coordinate heavy local workloads across worktrees, processes, and subagents — benchmarks and timing-sensitive gates run exclusively on a quiesced machine, while builds, test suites, regeneration…

    568 GitHub stars~821 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Cxas Agent Foundry

    GoogleCloudPlatform/cxas-scrapi

    End-to-end GECX/CXAS/CES conversational agent lifecycle -- build agents from requirements (PRD-to-agent), create and run evals (goldens, simulations, tool tests, callback tests), debug failures, and…

    107 GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Megalinter Setup

    nvuillam/github-dependents-info

    Install or upgrade MegaLinter on a repository. An agent skill from nvuillam/github-dependents-info.

    162 GitHub stars~3.9k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Delegate Verbose

    timusus/Shuttle2

    Run high-volume work in a subagent so its raw output never enters this conversation.

    229 GitHub stars~864 tokensUpdated yesterday
    MobileAuto-check passed
  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from sangrokjung/claude-forge

All 24 skills in this repo
  • Debugging Strategies

    sangrokjung/claude-forge

    Master systematic debugging techniques, profiling tools, and root cause analysis to efficiently track down bugs across any codebase or technology stack.

    850 GitHub starsUsed in 13 repos~3.1k tokens
    Auto-check passed
  • Dependency Upgrade

    sangrokjung/claude-forge

    Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing.

    850 GitHub starsUsed in 12 repos~2.3k tokens
    Auto-check passed
  • Skill Factory

    sangrokjung/claude-forge

    Analyze session work and automatically convert reusable patterns into Claude Code skills.

    850 GitHub stars~2.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Cc Dev Agent

    sangrokjung/claude-forge

    A skill your agent uses when starting Claude Code projects, writing CLAUDE.md/spec.md, dispatching subagents, or requesting Agent Teams parallel development.

    850 GitHub stars~771 tokensUpdated 1 mo ago
    Auto-check passed
  • Continuous Learning V2

    sangrokjung/claude-forge

    Instinct-based learning system that observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents.

    850 GitHub starsUsed in 6 repos~1.8k tokens
    Auto-check passed
  • Harness Diet

    sangrokjung/claude-forge

    Measure and shrink the always-loaded context of a Claude Code harness (CLAUDE.md + rules without paths frontmatter) back under budget — migrate narrative to reference files, convert rules to…

    850 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Verification Engine

What does Verification Engine do?

A skill your agent uses when verifying build/test/lint before commit, PR, or completion claims. Verification Engine is an agent skill from sangrokjung/claude-forge. Use when verifying build/test/lint before commit, PR, or completion claims.

When should I use Verification Engine?

Verification Engine fits situations like: verifying build/test/lint before commit; completion claims; /handoff-verify; pre-commit check.

How do I install Verification Engine in Claude Code?

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

How do I install Verification Engine in Codex?

Run `npx skills add sangrokjung/claude-forge --skill verification-engine -a codex`. Or copy the skill folder (skills/verification-engine in sangrokjung/claude-forge) into .agents/skills/verification-engine in your project. Codex loads it when a task matches its description.

Can I use Verification Engine 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 sangrokjung/claude-forge --skill verification-engine -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-engine, .gemini/skills/verification-engine, .github/skills/verification-engine and .opencode/skills/verification-engine in your project.

What does Verification Engine need to run?

Going by SKILL.md and its folder, Verification Engine needs the command-line tools its instructions call (eslint).

Does Verification Engine 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 Engine 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. Review the folder before installing.

What licence does Verification Engine use?

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

About 1.5k tokens (SKILL.md is roughly 5.8k 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 Engine?

Skills that share tags, products or a category with Verification Engine: Qwen Agent (thananon/9arm-skills, 3.2k stars), Bench Baton (nooga/let-go, 568 stars), Cxas Agent Foundry (GoogleCloudPlatform/cxas-scrapi, 107 stars) and Megalinter Setup (nvuillam/github-dependents-info, 162 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Verification Engine?

sangrokjung (a GitHub user) maintains it in sangrokjung/claude-forge, which has 850 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 3, 2026.

Source: sangrokjung/claude-forge on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.