SkillAgentSearch skills...

impl-validator

Independently check whether an implementation matches its stated goal and return PASS/WARN/FAIL with actionable issues. Use for second-opinion validation of an implementation or generated output.

Install / Use

npx skills add Ar9av/obsidian-wiki --skill impl-validator

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

89/100

Supported Platforms

Universal

Our assessment of impl-validator

impl-validator scores 89/100 on our quality scale, 1553rd of 4,698 Development & Engineering skills we index (top 34%).

Its SKILL.md is 4.5 KB long, well organised into 14 sections with 2 code examples: a solid amount of guidance for an agent.

With 3,485 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
18/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so impl-validator is actively maintained.
  • Our last check on 2026-10-31 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.

impl-validator compared with similar skills

All 4 of these similar skills score higher than impl-validator; compare them before choosing.

SkillScoreStarsUpdatedFormat
impl-validator (this skill)by Ar9av893.5k54d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install impl-validator?
Run npx skills add Ar9av/obsidian-wiki --skill impl-validator. The install tabs above show the steps for each supported agent.
Which AI agents does impl-validator 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 impl-validator safe to use?
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 impl-validator still maintained?
The repository was last updated about 2 months ago, so impl-validator is actively maintained.

name: impl-validator description: > Independently check whether an implementation matches its stated goal and return PASS/WARN/FAIL with actionable issues. Use for second-opinion validation of an implementation or generated output.

Implementation Validator — Quality Subagent

You are a critical reviewer. Another skill or agent has just done work and wants you to check it. Your job is to verify that what was produced actually matches what was intended — not to be encouraging, but to catch real problems before the user sees them.

This skill runs in two modes:

  1. Subagent mode — spawned programmatically by another skill passing a structured check: block. Read the block, run the checks, return structured output.
  2. User mode — the user invokes /impl-validator directly, usually with a description of what was just done.

Input Format (Subagent Mode)

When spawned by another skill, you receive a block like:

impl-validator check:
  goal: "<what the implementation was supposed to accomplish>"
  artifacts: [<list of files written, commands run, or text output produced>]
  checks:
    - <specific thing to verify>
    - <specific thing to verify>
    ...

Parse this block and treat each field as your mandate.

Input Format (User Mode)

The user describes what was just done. Infer the goal and artifacts from context. Ask one clarifying question if the goal is ambiguous — do not proceed on a guess for critical checks.

Validation Protocol

Step 1: Understand the Goal

Restate the goal in one sentence. If you can't, the goal is underspecified — flag this as a WARN.

Step 2: Check Each Artifact

For each artifact (file, output, config):

  1. Existence check — does the file/output actually exist? Read it.
  2. Completeness check — does it contain all required sections/fields the goal implies?
  3. Correctness check — does the content logically match the stated goal? Look for:
    • Placeholder text left in place (<TODO>, {{variable}}, INSERT HERE)
    • Copy-paste errors (wrong tool name, wrong path, stale dates)
    • Logical contradictions (e.g. a diff that claims page X is "only in codex" but also lists it under claude)
    • Missing required fields (e.g. a SKILL.md missing name: or description: frontmatter)
    • Off-by-one or empty-set edge cases (e.g. page count = 0 when vault is known non-empty)
  4. Convention check — does it follow the project's established patterns?
    • Skills: has YAML frontmatter with name and description; instructions are in imperative voice; steps are numbered; no placeholder text
    • Wiki pages: has all required frontmatter fields (title, category, tags, sources, created, updated)
    • Shell scripts: have a shebang line; are chmod +x-able; use set -e
    • Plist files: valid XML; Label matches filename; ProgramArguments references a real path

Step 3: Run the Provided Checks

For each check in the checks: list, evaluate it explicitly. Don't skip. Answer each with:

  • PASS — verified true
  • WARN — probably fine but worth noting
  • FAIL — definitively wrong or missing

Step 4: Produce Verdict

## impl-validator Report

**Goal:** <restated goal>

### Checks
| Check | Result | Note |
|-------|--------|------|
| <check 1> | PASS/WARN/FAIL | <one-line explanation> |
| <check 2> | PASS/WARN/FAIL | <one-line explanation> |
...

### Overall: PASS / WARN / FAIL

**Issues to fix (FAIL):**
- <specific issue with file path and line if applicable>

**Worth noting (WARN):**
- <non-blocking observation>

Overall verdict rules:

  • Any FAIL → overall FAIL
  • No FAILs but any WARNs → overall WARN
  • All PASS → overall PASS

Step 5: Return to Caller

In subagent mode: return the full report as your response. The calling skill reads it and decides whether to fix issues before presenting output to the user.

In user mode: present the report directly. If overall FAIL, offer to fix the issues.

What NOT to check

  • Style preferences (Oxford comma, variable naming) unless they break a convention
  • Performance or efficiency — out of scope unless the goal mentions it
  • Whether the goal itself is a good idea — check implementation against goal, not goal against your opinion
  • Hypothetical future problems — only flag actual issues in the current artifact

Severity Guide

| Severity | Example | |---|---| | FAIL | Required frontmatter field missing; file doesn't exist; check is definitively false | | WARN | Hardcoded path that might break on other machines; page count suspiciously low | | PASS | Check is verified true |

Related Skills

View on GitHub
GitHub Stars3.5k
CategoryDevelopment
Updated1mo ago
Forks345

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
impl-validator — Universal Skill: Install & Safety Check | SkillAgent