synesenom/ran / .claude/skills/validate
validate
VerifiedValidate Skill
You are validating that a GitHub issue's problem has been fully resolved by the current branch's implementation.
Core Principle
Verify that every acceptance criterion in the issue is satisfied by the actual code changes and that all tests pass. This is a post-implementation check — it does not fix anything, it only reports pass/fail.
Workflow
When the user invokes /validate <#issue> or /validate <issue-url>:
1. Load the Issue
- If a GitHub issue number is provided, fetch it:
gh issue view <number>(ormcp__github__issue_read) - If no argument is provided, infer the issue from the current branch name (e.g.
42-add-log-series-distribution→ issue #42)
Read the issue title, body, and acceptance criteria.
2. Extract Acceptance Criteria
Parse the issue body for acceptance criteria (checkboxes, "Acceptance Criteria" sections, numbered lists).
Issue #:
Acceptance criteria:
- <criterion 1>
- <criterion 2>
3. Gather Implementation Context
First sync the fresh upstream ref without touching the local main branch: git fetch origin main.
Then run these in parallel:
git diff origin/main...HEAD— full diffgit log origin/main..HEAD --oneline— commits
Also spawn the discovery-thoughts agent to find any related plan or research.
4. Verify Each Criterion
For each criterion:
a. Read the relevant code — use Glob and Grep to find it b. Trace the logic — confirm the behavior matches what was requested c. Check for tests — verify tests exercise this criterion d. For new distributions, verify:
- Entry added to
test/dist-cases.jswithinvalidParams,params, andcases - Distribution exported from
src/dist/index.js npm testpasses (KS/chi-squared test passes for sample output)
Mark each as PASS or FAIL with a brief explanation.
5. Run Tests
npm run standard
npm test
If tests fail, mark the test section as FAIL and include the failure output.
6. Generate Report
Validation: Issue # —
Acceptance Criteria:
# Criterion Status Evidence 1 PASS/FAIL <file:line or explanation> Tests:
- Linting (npm run standard): PASS/FAIL
- Test suite (npm test): PASS/FAIL
Verdict: PASS / FAIL ( criteria unmet, test failures)
7. Next Steps
- PASS: "Validation passed. Issue # is fully resolved by this branch."
- FAIL: "Validation failed. criteria unmet: ..."
Rules
DO:
- Check EVERY criterion
- Be specific about where each criterion is satisfied
- Run the full test suite even if criteria look good
DO NOT:
- Fix issues — only report them
- Skip running tests
- Mark a criterion as PASS without concrete evidence in the code
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |