CtrlK
BlogDocsLog inGet started
Tessl Logo

developer-setup

One-time onboarding for the developer workflow — installs github-workflow missions, creates the commitments workspace, registers per-repo projects, writes calibration memories. After successful setup this skill is excluded from selection until the marker file is deleted.

60

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/developer-setup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

The content is highly actionable with concrete mission_create and memory_write calls and a clear step sequence. The two areas holding it back are somewhat verbose mission-goal prose and implicit validation checkpoints for the batch per-repo and mission-install operations.

Suggestions

Tighten the long mission `goal` strings into terser bullet-style specifications to improve token efficiency.

Add explicit validation/verification checkpoints after batch operations (e.g., re-confirm repos were registered, list installed missions before writing the marker) to strengthen workflow clarity for the destructive/batch steps.

DimensionReasoningScore

Conciseness

The body is dense and actionable with no concept-explanation fluff, but the mission `goal` strings are long prose blocks that could be tightened, placing it at "mostly efficient but could be tightened" rather than fully lean.

2 / 3

Actionability

Provides fully executable, copy-paste-ready guidance — `mission_create(...)` and `memory_write(...)` calls with exact targets, content, cron cadences, and file paths — matching the score-3 anchor.

3 / 3

Workflow Clarity

Steps 1-7 are clearly sequenced with some validation (API repo validation, file-existence checks, a confirm-with-user gate before the marker), but batch operations like per-repo setup and multi-mission install lack explicit feedback loops/checkpoints, which per the guidelines caps workflow clarity at 2.

2 / 3

Progressive Disclosure

No bundle files exist and the skill references other skills by invocation rather than nested bundled files; the single file is well-organized into clearly headed Steps 1-7 with a navigation table, which per the scoring notes merits a 3 for skills with no external references.

3 / 3

Total

10

/

12

Passed

Description

67%

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

The description is specific and distinctive, listing concrete setup actions and a clear lifecycle. Its main weakness is the absence of explicit "Use when..." trigger guidance and natural user keywords, which leaves completeness and trigger-term quality at the mid level.

Suggestions

Add an explicit "Use when..." clause stating when a user would invoke this (e.g., "Use when onboarding a developer workflow: setting up commitment tracking and GitHub automation across repos.") to raise completeness.

Surface a couple of natural trigger phrases a user would say (e.g., "developer setup", "set up my GitHub workflow") directly in the description to improve trigger-term quality.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "installs github-workflow missions, creates the commitments workspace, registers per-repo projects, writes calibration memories" — plus a lifecycle detail, matching the score-3 anchor for multiple specific concrete actions.

3 / 3

Completeness

Clearly states what the skill does, but "when to use it" is only implied by "One-time onboarding" with no explicit "Use when..." clause, which per the guidelines caps completeness at 2.

2 / 3

Trigger Term Quality

Contains relevant domain terms ("developer workflow", "github-workflow missions") but no natural user-facing trigger phrases a person would say; the actual keywords live in activation.keywords rather than the description, so common natural variations are missing.

2 / 3

Distinctiveness Conflict Risk

Occupies a clear niche — one-time developer-workflow onboarding tied to a marker-file lifecycle — making it unlikely to trigger for unrelated skills.

3 / 3

Total

10

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
nearai/ironclaw
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.