verification-suite
Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.
Install / Use
npx skills add a5c-ai/babysitter --skill verification-suiteInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of verification-suite
verification-suite scores 92/100 on our quality scale, 879th of 2,790 Automation skills we index (top 32%).
Its SKILL.md is 8.7 KB long, well organised into 24 sections with 10 code examples: a thorough specification that gives an agent plenty to work with.
With 1,809 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so verification-suite is actively maintained.
- Our last check on 2026-10-27 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
verification-suite compared with similar skills
All 4 of these similar skills score higher than verification-suite; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| verification-suite (this skill)by a5c-ai | 92 | 1.8k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install verification-suite?
- Run
npx skills add a5c-ai/babysitter --skill verification-suite. The install tabs above show the steps for each supported agent. - Which AI agents does verification-suite work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is verification-suite safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is verification-suite still maintained?
- The repository was last updated about 2 months ago, so verification-suite is actively maintained.
Skill content
View source on GitHubname: verification-suite description: Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete. allowed-tools: Read Glob Grep Bash(*) metadata: author: babysitter-sdk version: "1.0.0" category: gsd-core backlog-id: SK-GSD-007 graph: domains: [domain:software-engineering] skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop] workflows: [workflow:feature-development] topics: [topic:developer-experience] roles: [role:tech-lead, role:backend-engineer]
- Is this plan structurally valid? (XML task format, required sections, frontmatter)
- Is this phase complete? (all plans executed, summaries written, state updated)
- Do all references resolve? (no broken links, missing files, stale references)
- Do expected artifacts exist? (outputs from each phase are present)
- Is requirements coverage at 100%?
- Is the
.planning/directory healthy?
This corresponds to the original lib/verify.cjs module and the verification patterns in references/verification-patterns.md.
Capabilities
1. Plan Structure Validation
Validate a PLAN.md file for structural correctness:
Checks:
[PASS] Frontmatter present with required fields (status, phase, wave, task_count)
[PASS] XML task blocks present and well-formed
[PASS] Each task has <task>, <context>, <acceptance_criteria> elements
[PASS] Task count matches frontmatter task_count
[FAIL] Task 3 missing <acceptance_criteria> element
[WARN] No depends_on field in frontmatter (optional but recommended)
XML task format:
<task id="1" title="Implement login endpoint">
<context>
Build POST /api/auth/login endpoint with email/password validation.
</context>
<acceptance_criteria>
- Endpoint accepts POST with email and password
- Returns JWT token on success
- Returns 401 on invalid credentials
- Rate limits to 5 attempts per minute
</acceptance_criteria>
</task>
2. Phase Completeness Checks
Verify a phase has all expected artifacts:
Phase 72 completeness:
[PASS] PLAN-1.md exists and status=executed
[PASS] PLAN-2.md exists and status=executed
[PASS] SUMMARY.md exists with commits and files lists
[PASS] STATE.md updated with phase 72 in completed_phases
[FAIL] VERIFICATION.md missing (verification not run)
[WARN] No CONTEXT.md (discuss-phase was skipped)
Completeness: 4/6 checks passed (67%)
Required for completion: VERIFICATION.md must be created
3. Reference Integrity Verification
Check that all file references in GSD artifacts are valid:
Reference integrity scan:
.planning/ROADMAP.md
[PASS] Phase 72 directory exists: .planning/phase-72/
[PASS] Phase 73 directory exists: .planning/phase-73/
.planning/phase-72/PLAN-1.md
[PASS] Referenced file src/auth/oauth.ts exists
[PASS] Referenced file src/auth/tokens.ts exists
[FAIL] Referenced file src/auth/middleware.ts does NOT exist
.planning/STATE.md
[PASS] Current phase 72 exists in ROADMAP.md
[PASS] All completed_phases exist in ROADMAP.md
4. Artifact Existence Verification
Verify expected outputs from a phase exist:
Phase 72 expected artifacts:
[PASS] src/auth/oauth.ts created (from PLAN-1.md task 1)
[PASS] src/auth/tokens.ts created (from PLAN-1.md task 2)
[PASS] src/middleware/auth.ts created (from PLAN-2.md task 1)
[FAIL] src/auth/__tests__/oauth.test.ts missing (from PLAN-2.md task 3)
5. Requirements Coverage Analysis
Map requirements to phase deliverables:
Requirements coverage:
R1 (project scaffolding) -> Phase 70 [completed] -> PASS
R5 (user auth) -> Phase 72 [completed] -> PASS
R7 (REST API) -> Phase 73 [planned] -> PENDING
R12 (admin dashboard) -> NOT MAPPED -> FAIL
Coverage: 12/13 mapped (92%)
Gap: R12 needs a phase assignment
6. Planning Directory Health Check
Comprehensive health assessment:
.planning/ health check:
[PASS] config.json exists and valid
[PASS] PROJECT.md exists
[PASS] REQUIREMENTS.md exists
[PASS] ROADMAP.md exists
[PASS] STATE.md exists and parseable
[WARN] phase-70/ has no SUMMARY.md (orphaned phase?)
[FAIL] phase-72/PLAN-3.md references non-existent wave 4
[INFO] 2 debug sessions found in debug/
[INFO] 5 quick tasks found in quick/
Health: 5 pass, 1 warn, 1 fail
Recommendation: Run gsd health --fix to repair issues
7. Milestone Audit Report
Generate comprehensive milestone readiness report:
# Milestone Audit: v1.0
## Phase Completion
| Phase | Status | Plans | Summary | Verification |
|-------|--------|-------|---------|--------------|
| 70 | verified | 2/2 executed | present | passed |
| 71 | verified | 3/3 executed | present | passed |
| 72 | completed | 2/2 executed | present | NOT RUN |
| 73 | completed | 2/2 executed | present | passed |
## Requirements Coverage
12/13 requirements covered (92%)
Gap: R12 (admin dashboard) - not in v1.0 scope
## Integration Points
3 integration points identified, 2 verified
## Audit Result: CONDITIONAL PASS
- Phase 72 needs verification
- R12 confirmed out of v1.0 scope
8. Test Coverage Analysis
For add-tests process, analyze what needs testing:
Phase 72 test coverage:
src/auth/oauth.ts
Functions: loginUser, refreshToken, revokeToken
Existing tests: none
Recommended: unit tests for all 3 functions
src/middleware/auth.ts
Functions: requireAuth, requireRole
Existing tests: none
Recommended: unit tests + integration tests
Tool Use Instructions
Validating Plan Structure
- Use
Readto load the plan file - Check frontmatter presence and required fields
- Use regex patterns to find and validate XML task blocks
- Count tasks and compare to frontmatter task_count
- Check each task has required elements (context, acceptance_criteria)
Checking Phase Completeness
- Use
Globto find all files in the phase directory - Check for expected files (PLAN-*.md, SUMMARY.md, VERIFICATION.md)
- Use
Readto check plan statuses in frontmatter - Use
Grepto check STATE.md for phase in completed_phases - Return completeness report
Scanning Reference Integrity
- Use
Readto load each GSD artifact - Extract file paths and references from content
- Use
GloborBash(ls)to verify each reference exists - Categorize as PASS/FAIL/WARN
Health Check
- Use
Globto inventory all.planning/contents - Run structure, completeness, and integrity checks
- Identify orphaned files and missing links
- Generate health report with recommendations
Process Integration
plan-phase.js- Validate plan structure after planner generates plansexecute-phase.js- Verify phase completeness after executionverify-work.js- Artifact existence verification during UATaudit-milestone.js- Full milestone audit report generationadd-tests.js- Test coverage analysis for test generationhealthcommand - Full planning directory health check
Output Format
{
"operation": "validate_plan|check_phase|check_refs|check_artifacts|coverage|health|audit|test_coverage",
"status": "pass|fail|warn",
"checks": [
{ "name": "frontmatter_present", "status": "pass", "detail": "" },
{ "name": "xml_tasks_valid", "status": "fail", "detail": "Task 3 missing acceptance_criteria" }
],
"summary": {
"total": 6,
"passed": 4,
"failed": 1,
"warnings": 1
},
"recommendations": ["Fix Task 3 in PLAN-1.md"]
}
Configuration
| Setting | Default | Description |
|---------|---------|-------------|
| strictMode | false | Treat warnings as failures |
| requireVerification | true | Require VERIFICATION.md for phase completion |
| requireContext | false | Require CONTEXT.md for phase completion |
| coverageThreshold | 100 | Minimum requirements coverage percentage |
Error Handling
| Error | Cause | Resolution |
|-------|-------|------------|
| Plan parse error | Malformed XML tasks or YAML frontmatter | Show specific syntax error location |
| Phase directory missing | Expected phase directory does not exist | Create directory or update roadmap |
| Stale reference | Referenced file was moved or deleted | Update reference or remove |
| Coverage gap | Requirement not mapped to any phase | Add phase or update existing phase mapping |
Constraints
- Verification is read-only; it never modifies files (only reports issues)
- Plan validation requires XML task format (not arbitrary markdown)
- Phase completeness checks are configurable (strict vs relaxed)
- Health check scans the entire
.planning/directory recursively - Milestone audit must verify all phases in the milestone scope
- Test coverage analysis examines actual source files, not just plan references
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
