CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gitnexus-cli

Use when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos. Examples: "Index this repo", "Reanalyze the codebase", "Generate a wiki"

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

SKILL.md
Quality
Evals
Security

Quality

Content

76%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 CLI reference: copy-paste commands, flag tables with defaults, when-to-run cues, and a troubleshooting section. The two weaknesses are the missing validation around the destructive `clean`/`--all` workflow (which caps workflow clarity) and a handful of over-dense passages that could move to reference files.

Suggestions

Add a validation step to the clean workflow — e.g. run `node .gitnexus/run.cjs status` first to confirm the target index, and warn that `--all` is irreversible across every registered repo.

Move the watch-mode flag restrictions, the Spring Actuator/AsyncAPI enrichment details, and the wiki provider matrix into a reference file, keeping one-line summaries in SKILL.md.

Tighten the long multi-clause sentences in the runner-selection and npm 11.x paragraphs into short bullet guidance.

DimensionReasoningScore

Conciseness

The bulk is lean and operational — command invocations plus flag tables with defaults, no explanations of concepts Claude already knows. Not a 5 because a few passages could be trimmed: the dense watch-mode paragraph ("MCP checks are throttled to once every five seconds, so a tool call before the next check can briefly use the previous index") and the npm 11.x workaround aside carry edge-case detail beyond the skill's core task.

4 / 5

Actionability

Every command is copy-paste ready ("node .gitnexus/run.cjs analyze") and flags come with defaults and effects in tables ("--debounce <ms>", "default: 300 ms"). This matches the anchor for fully executable, copy-paste-ready commands covering the common cases; nothing is pseudocode or vague.

5 / 5

Workflow Clarity

There is a clear "When to run" cue and an "After Indexing" checklist with a verify step ("Read gitnexus://repo/{name}/context to verify the index loaded") plus a Troubleshooting section. However, `clean` is a destructive and batch-capable operation ("Deletes the .gitnexus/ directory and unregisters the repo", `--all` cleans every indexed repo, `--force` skips confirmation) with no validation step before or after, which caps this dimension at 3 per the destructive/batch-operation rule.

3 / 5

Progressive Disclosure

No bundle files exist, and the single body is well organized into per-command sections, storage/retention, after-indexing, and troubleshooting — matching 'Good structure; most content is appropriately placed'. Not a 5 because deep operational detail (watch-mode semantics, the Spring Actuator/AsyncAPI enrichment paragraphs, wiki provider matrix) is inlined where a reference file would keep the overview shorter.

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: explicitly scoped to a named tool, enumerates the concrete command set, and closes with natural example trigger phrases. The only weakness is minor keyword coverage gaps (e.g. re-index/documentation synonyms) and slightly generic example phrases that could compete with sibling skills.

Suggestions

Add a synonym such as "re-index/rebuild the index" to the examples so the common phrasing of the analyze action is covered.

Qualify "Generate a wiki" with the tool name (e.g. "Generate a GitNexus wiki") to reduce overlap with generic documentation-generation skills.

DimensionReasoningScore

Specificity

The description lists five concrete actions — "analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos" — which comprehensively covers the skill's command surface. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; it is not the level below because no action named is generic.

5 / 5

Completeness

It explicitly answers both questions: 'what' is running GitNexus CLI commands (analyze, status, clean, wiki, list) and 'when' is an explicit "Use when the user needs to run GitNexus CLI commands like..." clause with concrete trigger phrases. This matches the anchor for a clear and explicit what AND when.

5 / 5

Trigger Term Quality

It supplies natural example utterances users would actually say — "Index this repo", "Reanalyze the codebase", "Generate a wiki" — plus command keywords. Not a 5: common variations such as "re-index", "reindex the codebase", or "generate docs/documentation" are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — everything is scoped to the named tool "GitNexus CLI" — giving mostly distinct triggers. Not a 5: phrases like "Reanalyze the codebase" and "Generate a wiki" are generic enough to compete with other GitNexus skills (exploring, debugging) or general documentation-generation skills.

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

gitnexus-claude-plugin/skills/gitnexus-cli/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.