CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

quinnod345/ponder

Convergent multi-pass deliberation and code review ledger that enumerates units, grades every unit against a lens rubric, runs four-perspective deliberation (Skeptic, Builder, Dreamer, Empath), records append-only finding deltas, verifies phantom-unit removals across all historical paths, and enforces 1.00 coverage and zero-churn convergence before stopping. Use when the user says "ponder <anything>" ("ponder the UI", "ponder our error handling", "ponder this PR"), "run a ponder audit", "grade every unit with the ponder ledger", "run four-voice Skeptic/Builder/Dreamer/Empath deliberation", or asks for a coverage-gated multi-pass lens audit across files or screens where stopping early would miss units. Also use to resume or recover a ponder session in flight - "where were we in the ponder", "carry on pondering", or an existing .ponder/ directory - by running ponder status rather than starting over.

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Overview
Quality
Evals
Security
Files

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a dense, fully executable protocol: every phase has a literal command, validation is enforced at each decision point by the engine (exit 2 semantics), and error-recovery paths (out-of-order, interrupted, oscillating) are each specified. Detail is correctly split across four real, one-level-deep reference files, keeping the main file to the loop itself.

DimensionReasoningScore

Conciseness

The body contains no explanation of concepts Claude already knows — every line is operational: commands with flags ("ponder start \"the UI\" --lens ui --max-passes 6 --min-passes 2"), exit codes ("Out-of-order commands exit 2"), and non-obvious rationale that earns its tokens ("setEncoding(\"utf8\") prevents UTF-8 chunk boundary corruption; keep shards in .ponder/tmp/batch/ so cat globs never match their own output file"). Nothing can be trimmed without losing an operational fact, matching the 5 anchor.

5 / 5

Actionability

Fully executable throughout: literal commands for every phase ("ponder units --file .ponder/tmp/units.json --scan src/routes --strict-scope", "ponder delta --file .ponder/tmp/deltas-2.jsonl"), a complete seven-operation delta JSONL example showing all required fields, an executable codex exec fan-out snippet with the exact node wrap step, and a five-command resumption sequence. Examples cover pass 1, pass 2+, the quiet pass, and the phantom-delete case, matching the 5 anchor (copy-paste ready, common cases covered).

5 / 5

Workflow Clarity

The loop is sequenced as seven numbered steps in explicit order plus a stated pass-2+ variant ("predict -> deliberate -> delta -> judge -> decide"), with validation checkpoints throughout ("ponder doctor", "--strict-scope exits 2 if any file... was omitted", "ponder verify --repair", "exit 2 on unledgered edits") and feedback loops for error recovery (out-of-order commands print the owed phase, "escalate" on thrash > 0.25, budget-stop vs. converged-stop distinction, stopping criteria as an explicit checklist). Batch fan-out includes validation (strict-scope, verify reconciliation), so the batch-operation cap does not apply; this matches the 5 anchor rather than 4.

5 / 5

Progressive Disclosure

Scored against the actual bundle: all four referenced files exist (references/protocol.md, perspectives.md, harness-notes.md, worked-example.md), are one level deep (verified no nested delegation — the only cross-file mention is a harness path-resolution note), and each is listed with a one-line scope description under "Deeper references (load only when needed)". The operational loop stays inline while per-command flags, JSON shapes, and verdict rules are pushed to references, exactly matching the 5 anchor (clear overview, well-signaled one-level-deep references, appropriate split).

5 / 5

Total

20

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it explicitly answers what and when with literal example utterances, covers resumption as a second use case, names its four perspectives, and marks its on-disk artifact (.ponder/) — all in third person. Its only weakness is density: the opening what-sentence is a ~60-word run-on that trades skimmability for completeness, though no clause is fluff.

DimensionReasoningScore

Specificity

The description lists six-plus concrete actions covering the entire capability surface: "enumerates units, grades every unit against a lens rubric, runs four-perspective deliberation (Skeptic, Builder, Dreamer, Empath), records append-only finding deltas, verifies phantom-unit removals across all historical paths, and enforces 1.00 coverage and zero-churn convergence before stopping" — plus resumption via "ponder status". This matches the comprehensive-coverage anchor; it is not 4 because no capability area is missing.

5 / 5

Completeness

Both what and when are explicit with concrete trigger phrases: the what is the enumerated action list ("Convergent multi-pass deliberation and code review ledger that enumerates units...") and the when is "Use when the user says 'ponder <anything>'... or asks for a coverage-gated multi-pass lens audit across files or screens where stopping early would miss units. Also use to resume or recover a ponder session in flight...". This directly matches the 5 anchor (clear what AND when with concrete triggers) and exceeds the 4 anchor (when could be more explicit).

5 / 5

Trigger Term Quality

It quotes literal user utterances — "ponder the UI", "ponder our error handling", "ponder this PR", "run a ponder audit", "grade every unit with the ponder ledger", "where were we in the ponder", "carry on pondering" — generalizes the pattern ("ponder <anything>"), and includes the ".ponder/" directory artifact marker. Coverage of natural terms, variations, and artifacts is comprehensive, matching the 5 anchor rather than the 4 anchor (a few natural terms missing).

5 / 5

Distinctiveness Conflict Risk

Every trigger phrase is branded with the unique keyword "ponder", and the skill's artifacts (.ponder/ directory, lens rubric, Skeptic/Builder/Dreamer/Empath voices, f-NNNN findings) belong to a clear niche no other skill would claim. The single non-branded trigger ("coverage-gated multi-pass lens audit across files or screens") is itself specialized enough to carry minimal overlap risk, so this fits the 5 anchor (clear niche, minimal conflict) rather than 4 (minor overlap with closely related skills).

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

On this page