CtrlK
BlogDocsLog inGet started
Tessl Logo

harness-init

One-time, guided setup of the local agent-first coding harness — the polling loop, the deterministic dispatcher, its config, the AGENTS.md contract, and the worktree provisioning that makes per-feature worktrees runnable. Use when a developer wants to set up, bootstrap, install, or initialize the coding harness for the first time in a project.

70

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

A highly actionable, well-sequenced guided workflow with strong validation checkpoints and a genuinely progressive reference structure — every command, copy path, and template is concrete and every referenced bundle file exists. Its weaknesses are repetition of the memory-loop-is-separate point across four sections and inline duplication of detail that already lives in the references.

Suggestions

State the "two loops never block each other / memory loop is a separate loop" point once (Step 2) and cross-reference it from Steps 9–10 and the Inner-skill-dependency section instead of restating it each time.

Move the Step 7 auth-mode tradeoffs (subscription vs. metered API billing detail) into references/reviewer-options.md, keeping only the decision question and the mechanical pin/uncomment steps inline.

Trim the Step 2 dispatcher walk-through to the load-bearing highlights (wrapper sync rationale, bootstrap hook, convergence exit) and point to the section map in references/dispatcher-explained.md for the rest.

DimensionReasoningScore

Conciseness

The body is mostly load-bearing, project-specific knowledge Claude could not guess, but it repeats the "two loops never block each other / memory loop is separate" point across Step 2, Step 9, Step 10, and the Inner-skill-dependency section, and Step 2's walk-through and Step 7's auth tradeoffs restate detail already in references/dispatcher-explained.md and references/reviewer-options.md. This is more than minor over-explanation (anchor 4) but well short of heavily padded generic content (anchor 2), landing on "mostly efficient but could be tightened".

3 / 5

Actionability

Guidance is fully executable throughout: exact copy commands ("git worktree add --detach ../<repo>-harness origin/main", "/loop 5m /poll-and-dispatch", "gh release view --repo anthropics/claude-code-action"), exact source→destination file paths for every artifact, an explicit .gitignore block, and chmod instructions with the exception (harness-lib.sh is sourced, not executed). Every generated artifact is backed by a real template in assets/, so nothing relies on improvisation.

5 / 5

Workflow Clarity

Steps 0–10 are clearly sequenced with explicit validation checkpoints: preflight gates the run, Step 8's provisioning "doubles as validation of the bootstrap script" with fix-and-re-run, Step 9 dry-runs both tick scripts and instructs "If anything errors, debug before starting the loops", and the confirm → do → show → adjust loop with the user runs through the whole flow. Re-run and STUCK-path handling add error-recovery feedback loops, matching the anchor-5 pattern.

5 / 5

Progressive Disclosure

All nine references/ and twelve assets/ files are referenced by exact path, one level deep, verified to exist, with a prioritized "read first" list and per-step reference loading — good structure overall. However, the ~320-line body inlines reference-level detail (the Step 2 dispatcher walk-through and Step 7 auth-mode tradeoffs) that duplicates dispatcher-explained.md and reviewer-options.md, so some content that should live in the referenced files is inline, keeping it below anchor 5.

4 / 5

Total

17

/

20

Passed

Description

92%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.

A strong description that clearly and explicitly states what it does (one-time guided setup of five named harness artifacts) and when to use it (multiple natural trigger verbs scoped to first-time setup of a coding harness). The only weakness is slightly limited trigger-term variety around how users might phrase the request.

DimensionReasoningScore

Specificity

The description enumerates five concrete artifacts it sets up — "the polling loop, the deterministic dispatcher, its config, the AGENTS.md contract, and the worktree provisioning that makes per-feature worktrees runnable" — giving comprehensive, specific coverage of what the skill does rather than vague domain language. This matches the anchor-5 pattern of listing multiple specific concrete actions; there are no coverage gaps for a setup skill.

5 / 5

Completeness

It explicitly answers both questions: the "what" is "One-time, guided setup of the local agent-first coding harness" with enumerated artifacts, and the "when" is a concrete "Use when a developer wants to set up, bootstrap, install, or initialize the coding harness for the first time in a project." This is a direct match for the anchor-5 example structure (what + Use-when with trigger phrases).

5 / 5

Trigger Term Quality

The when-clause includes four natural synonym verbs users would actually say — "set up, bootstrap, install, or initialize" — plus "for the first time in a project", which is good keyword coverage. A few natural phrasings are missing (e.g. "stand up the harness", "get the harness running"), and the object term is limited to "coding harness", so it sits between anchors 4 and 5, noticeably above the midpoint but not fully comprehensive.

4 / 5

Distinctiveness Conflict Risk

"Local agent-first coding harness" with niche artifacts ("polling loop", "deterministic dispatcher", "AGENTS.md contract") carves a clear, distinct trigger niche with minimal conflict risk. The generic verbs ("install", "initialize") carry overlap potential, but they are bound to the specific object "the coding harness", which matches the anchor-5 example of a distinct trigger set; not anchor 4, since no closely related skill would plausibly capture these triggers.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 6 missing, 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository
tdg-ninja/context-specs-factory-ai
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.