CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gitnexus-plan

Use when you need a deep, implementation-ready engineering plan for a code change — built from GitNexus graph intelligence, statement-level PDG analysis, and targeted source verification, compact enough that an implementation agent can start without re-investigating. Also strengthens existing plans via Deepen mode. Examples: "/gitnexus-plan Add retry support to the ingestion pipeline", "/gitnexus-plan deepen docs/plans/<plan>.md", "plan this change using the knowledge graph".

Quality

85%

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

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

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.

An exceptionally operational skill file: the phase workflow, tool-call ladder, budgets, gates, and failure handling are concrete and executable, and reference files are well-signaled and genuinely one level deep. The main cost is repetition of the evidence-provenance/write-plan contract across four sections of the body, which inflates length without adding information.

Suggestions

State the write-plan/read-plan provenance contract once (e.g., a short Hard-rules pointer to scripts/evidence-provenance.mjs plus references/evidence-provenance.md) and let Phases 4/5 and Deepen reference it instead of restating digest, byte-contract, and path-validator details.

Move the Deepen-mode step detail (re-anchoring rules, --replace receipt handling) into a references/deepen.md file, keeping a compact step list in the body, to shorten the main file and sharpen progressive disclosure.

Trim redundant restatements of the same rule (e.g., 'a Deepen run is its own session' appears in both Phase 1 and Deepen mode) to improve token efficiency.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence (no explanations of graphs, PDGs, or planning concepts) and is dense with real constraints, but the evidence-provenance/write-plan/read-plan contract is restated in Hard rules, Phase 4, Phase 5, and twice in Deepen mode even though references/evidence-provenance.md owns the detail — 'mostly efficient but could be tightened'. Not 4: the repetition across four sections is more than 'minor instances of over-explanation'; not 2: there is no padding or teaching of known concepts.

3 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact tool signatures ('query {search_query, task_context}', 'impact {target, direction}'), exact commands ('node .gitnexus/run.cjs analyze --index-only', 'scripts/evidence-provenance.mjs write-plan'), a normalized output path format ('docs/plans/YYYY-MM-DD-gitnexus-plan-<slug>.md'), per-category budgets in a table, and per-knob defaults with meanings. Every step names the precise command or call to make.

5 / 5

Workflow Clarity

Phases 0–5 plus Deepen and Fallback modes are clearly sequenced, with explicit validation checkpoints throughout: the freshness gate and analyzer provenance check before refresh, one-retry rules for ambiguous results, source verification mandatory before citation, 're-anchor before re-pinning', digest/path mismatch blocking publication, and safe-write failure blocking plan release. These are genuine validate→fix→retry feedback loops of the kind the rubric rewards for write operations.

5 / 5

Progressive Disclosure

Structure is good: each reference file is real, one level deep, and its ownership is stated at the point of reference ('references/pdg-slice.md … owns the tool calls, inclusion criteria, depth bounds'), and the script's byte contract is delegated to references/evidence-provenance.md. Not 5: the ~330-line body inlines a fair amount of provenance-writer and Deepen-mode detail that duplicates what the reference files already own, so the split is not as clean as a pure overview-plus-references layout.

4 / 5

Total

17

/

20

Passed

Description

83%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: it states what the skill produces, when to use it, and how it differs (graph + PDG + source verification, Deepen mode), with concrete invocation examples. Its only weaknesses are slightly incomplete action coverage and missing common synonyms a user might naturally say when they want an engineering plan.

DimensionReasoningScore

Specificity

Concrete actions are named — 'deep, implementation-ready engineering plan', 'built from GitNexus graph intelligence, statement-level PDG analysis, and targeted source verification', 'strengthens existing plans via Deepen mode' — covering both modes with only minor gaps (e.g., producing the machine-readable context pack is not named as an action). Not 5: it stops slightly short of the 'multiple specific concrete actions; comprehensive coverage' anchor; not 3: it clearly exceeds '1-2 concrete actions'.

4 / 5

Completeness

Explicitly answers both questions: the what ('implementation-ready engineering plan for a code change — built from GitNexus graph intelligence, statement-level PDG analysis, and targeted source verification') and the when ('Use when you need a deep, implementation-ready engineering plan for a code change', plus concrete trigger examples). This matches the anchor-5 example structure of 'action list + Use when... with concrete trigger phrases'.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — 'engineering plan', 'plan for a code change', 'plan this change', 'knowledge graph', 'deepen' — reinforced by realistic invocation examples ('/gitnexus-plan Add retry support to the ingestion pipeline'). Not 5: common synonyms like 'blueprint', 'design', or 'implementation plan' phrasing variations are absent; not 3: coverage goes well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The GitNexus/PDG vocabulary carves a clear niche with distinct triggers, and Deepen mode is a distinctive capability. Not 5: the opening 'engineering plan for a code change' territory overlaps with generic planning/architecture skills that don't involve GitNexus; not 3: the 'gitnexus' / slash-command triggers make confusion with unrelated skills unlikely.

4 / 5

Total

17

/

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-plan/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.