CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gitnexus-work

Use when executing an engineering plan produced by gitnexus-plan (or a small bounded task directly) — implements step by step with GitNexus impact checks before every symbol edit, tests from the plan's scenarios, and detect_changes gating every commit. Examples: "/gitnexus-work docs/plans/2026-07-11-gitnexus-plan-ingestion-retry.md", "/gitnexus-work" (latest plan), "execute the plan".

Quality

85%

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

The canonical home for this skill is gitnexus-work in abhigyanpatwari/GitNexus

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally well-sequenced execution workflow with validation gates and feedback loops on every risky operation, backed by a real one-level-deep reference bundle. The main costs are token efficiency — repeated procedure naming, editorial asides, and a long inline build-freshness section — and MCP tool calls that stop short of copy-paste-ready form.

Suggestions

Move the six-step Build-current/index-current procedure into its own reference file and refer to it by name, cutting significant inline tokens and the repeated restatements of when to run it.

Trim editorial rationale (e.g., "the plan travels with the work it drives", "'the fix doesn't work' is more often 'the fix never loaded'") to bare instructions.

Show the exact MCP tool-call shapes for impact and detect_changes (as done for the evidence-provenance CLI) so every gate is copy-paste executable.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive but noticeably repetitive and padded in places: the "Build-current/index-current procedure" name is restated at least five times, and editorial asides like "the plan travels with the work it drives", "interleaving other work between the gate and the commit is how the gate gets skipped", and "'the fix doesn't work' is more often 'the fix never loaded'" could be trimmed without losing instruction. It is not a 2 because there is little explanation of concepts Claude already knows — nearly every line is skill-specific guidance; it is not a 4 because the repetition and rhetorical asides are more than minor.

3 / 5

Actionability

Most guidance is executable: exact commands like "scripts/evidence-provenance.mjs read-plan --repo <root> --generated-plan <candidate>", "node gitnexus/dist/cli/index.js analyze --index-only --pdg", "cd gitnexus && npm run build", and a concrete commit message format. It is not a 5 because the MCP tool calls (impact, detect_changes, status --json) are described semantically rather than as complete copy-paste invocations, and some parameters are placeholders that require assembly.

4 / 5

Workflow Clarity

The four-phase sequence is explicit with validation checkpoints throughout: a two-layer drift check, assumption re-verification, a pre-completed check, impact gates before every edit, detect_changes gating every commit with a defined stage → gate → commit unbroken sequence, and explicit failure handling (partial/truncated results block commits; procedure failure blocks completion). Feedback loops are present for every failure mode, including routing back to gitnexus-plan Deepen mode. This clearly matches the top anchor.

5 / 5

Progressive Disclosure

Structure is good: the deep evidence-provenance protocol is correctly delegated to the real, well-organized references/evidence-provenance.md (one level deep, clearly signaled), and the body uses clear section headings. It is not a 5 because the ~60-line inline "Build-current/index-current procedure" section is substantial content that could live in a reference file (the body even leans on it as a named procedure), and Phase 1's drift-check details partially duplicate the reference's territory.

4 / 5

Total

16

/

20

Passed

Description

88%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 explicitly covers what the skill does and when to use it, with concrete example invocations and specific gated-execution behaviors. Its only weaknesses are a few missing natural synonyms and a slight risk that bare "execute the plan" phrasing overlaps with non-gitnexus plan-execution skills.

Suggestions

Add one or two natural trigger synonyms (e.g., 'run the plan', 'implement the plan steps') alongside the existing example invocations to broaden trigger term coverage.

Sharpen distinctiveness by noting in one clause that this executes gitnexus-plan output specifically (vs. any plan), reducing overlap with generic plan-execution phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "implements step by step with GitNexus impact checks before every symbol edit", "tests from the plan's scenarios", and "detect_changes gating every commit" — giving comprehensive, specific coverage of what the skill does. It is not a 4 because there are no minor gaps: every core execution behavior is named.

5 / 5

Completeness

It explicitly answers both questions: the "what" ("implements step by step with GitNexus impact checks before every symbol edit, tests from the plan's scenarios, and detect_changes gating every commit") and the "when" ("Use when executing an engineering plan produced by gitnexus-plan (or a small bounded task directly)") with concrete example trigger phrases. Not a 4 because neither half needs more specificity.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases users would say ("executing an engineering plan", "execute the plan", plan-file paths) plus three concrete example invocations. It is not a 5 because common synonyms like "implement the plan", "carry out", or "run the steps" are missing, and several trigger terms ("GitNexus impact checks", "detect_changes") are repo-specific jargon rather than natural user phrasing.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear niche — plans produced by gitnexus-plan — with distinct example invocations like "/gitnexus-work docs/plans/...gitnexus-plan...md". Minor overlap risk remains with a generic "execute the plan" request or a sibling plan-execution skill, since "execute the plan" alone doesn't identify gitnexus-plan as the source, so it does not reach the minimal-conflict bar of 5.

4 / 5

Total

18

/

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.

Repository

abhigyanpatwari/GitNexus

Path

.claude/skills/gitnexus-work/SKILL.md

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.