CtrlK
BlogDocsLog inGet started
Tessl Logo

project-setup

Add a GitHub repository as a tracked project — creates workspace entity, installs workflow automation missions, and includes in dev brief scope.

60

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

83%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 content is lean, highly actionable, and well-sequenced with strong input validation up front, but the batch mission-install step lacks a verification/feedback checkpoint, which caps workflow clarity. Progressive disclosure is appropriately handled for a self-contained procedural skill.

Suggestions

Add a verification checkpoint after the Step 4 mission loop: confirm each mission_create succeeded (e.g. list/verify the created missions) before setting workflow_installed: true.

Include an explicit retry/error path for failed mission installs so the workflow has a validate->fix->retry feedback loop.

Note how to verify the project.md/notes.md writes succeeded (or that the directory projects/<owner>-<repo>/ exists) before reporting success in Step 5.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no preamble about what GitHub or workflows are, just a concrete API call, file templates, and a substitution checklist. Every section earns its place, with the only near-verbose part being the output template, which is itself actionable. It is not 4 because there is no padding or over-explanation to trim.

5 / 5

Actionability

Guidance is fully executable: an exact GitHub API call with URL, copy-paste-ready project.md/notes.md templates, a numbered substitution list with concrete defaults, and explicit mission_create(name, goal, cadence) calls. It is not 4 because the common cases (with and without staging) are covered with specific, runnable instructions.

5 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced with input validation in Step 1 (404/ambiguity handling), but the batch install of 6 missions in Step 4 has no verification checkpoint or feedback loop confirming missions were created before updating the project file. Per the batch-operation rule this caps workflow_clarity at 3. It is not 4 because the batch step lacks a validate->fix->retry checkpoint, and not 2 because the sequence and Step 1 validation are solid.

3 / 5

Progressive Disclosure

A single self-contained file is well organized into five labeled step sections, with the one external reference (github-workflow/references/workflow-routines.md) clearly signaled one level deep. It is not 5 because there is no overview-to-detail split to navigate — it is a linear procedure — and not 3 because structure is clean and the dependency reference is explicit rather than buried.

4 / 5

Total

17

/

20

Passed

Description

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

The description clearly conveys what the skill does with three concrete actions, but lacks an explicit 'Use when...' trigger clause and only weakly surfaces natural user keywords, capping completeness and trigger quality. It is specific and reasonably distinct from sibling skills.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user says add/track/setup a repo or wants a repository included in dev briefs and triage scans.'

Surface natural synonyms users actually say ('track repo', 'setup workflow', 'new project') alongside 'add GitHub repository' to improve trigger coverage.

Mention the failure/edge path briefly (e.g. 'reports if the repo is not found or access is denied') to round out capability coverage.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions — 'creates workspace entity', 'installs workflow automation missions', 'includes in dev brief scope' — giving specific behavior rather than vague language. It falls short of 5 because coverage is not comprehensive (no mention of validation, removal, or failure handling), and above 3 because it lists three distinct concrete actions rather than 1-2.

4 / 5

Completeness

The 'what' is clearly stated (add repo, create entity, install workflow, include in brief), but there is no 'Use when...' clause or equivalent explicit trigger guidance, so completeness is capped at 3 per the judging guidelines. It is not 4 because 'when' is only weakly implied by 'Add', not explicitly stated.

3 / 5

Trigger Term Quality

The opening 'Add a GitHub repository as a tracked project' captures a natural user phrase, but the description otherwise uses capability language ('workflow automation missions', 'dev brief scope') rather than trigger phrasing and omits common variations like 'track', 'setup', or 'new repo'. It is not 4 because keyword coverage is thin and missing synonyms, and not 2 because at least one natural phrase users would say is present.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly specific — onboarding a repo as a tracked project with workflow automation — which is mostly distinct, though it overlaps with the required 'github' and 'github-workflow' skills. It is not 5 because of that overlap risk with closely related skills, and not 3 because the trigger is more specific than generic 'works with GitHub'.

4 / 5

Total

14

/

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.

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.