CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

graphify

Use for any question about a codebase, its architecture, file relationships, or project content — especially when graphify-out/ exists, where the question should be treated as a graphify query first. Turns any input (code, docs, papers, images, videos) into a persistent knowledge graph with god nodes, community detection, and query/path/explain tools.

Quality

80%

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 ./.agents/skills/graphify/SKILL.md
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.

The body is an exceptionally actionable, well-gated pipeline runbook with real validation and recovery loops, and its use of one-level-deep, conditionally-loaded references is disciplined. Its main cost is token weight: systematic redundancy and bug-history commentary make it noticeably verbose for an always-loaded SKILL.md.

Suggestions

State the no-API-key rule once in Step 3 as a single blockquote instead of three separate ones, and drop the repeated "INPUT_PATH is read from graphify-out/.graphify_root; there is no path to substitute" lines in favor of one note near Step 1.

Trim issue-tracker archaeology (#2843, #1392, #2225, #1939, #479) to one-line rationale comments — keep the instruction, cut the multi-sentence bug narrative a maintainer would read in the repo, not the skill.

Move the Step B0–B3.5 cache/merge choreography into a references/extraction-cache.md and keep only the dispatch decision points inline, slimming the always-loaded body.

DimensionReasoningScore

Conciseness

The ~800-line body has several padded or redundant passages: the "never ask for an API key" rule is stated in three separate blockquotes in Step 3, "INPUT_PATH is read from graphify-out/.graphify_root; there is no path to substitute" is repeated three times, and long issue-tracker archaeology (#2843, #1392, #2225, #1939, #479) explains library internals far beyond what the agent needs to act. This matches "noticeably verbose; several unnecessary explanations or padded sections"; it is not a 3 because the redundancy is systematic rather than incidental.

2 / 5

Actionability

Fully executable bash/Python blocks with exact commands, and every placeholder (IS_DIRECTED, IS_FORCE, LABELS_DICT, SPEC_PATH, INPUT_PATH heredoc) has explicit substitution instructions plus fallback paths (interpreter detection, NetworkX query fallback, chunk-failure handling). Copy-paste ready and covers the common cases, matching the top anchor.

5 / 5

Workflow Clarity

Steps 0–9 are clearly sequenced with explicit validation checkpoints for this batch operation: empty-graph guard, the #479 shrink-guard, the Step 4.5 read-only health check, Step B3.5 coverage verification against real file lengths, and a stop rule when more than half the chunks fail — plus feedback loops (partially-read files cached as partial and retried on --update). This matches the anchor with explicit validation steps and error-recovery loops.

5 / 5

Progressive Disclosure

All 8 reference files exist on disk and are well-signaled, one level deep, and conditionally loaded at the right points (e.g. "Load it only here, only when at least one chunk holds a doc, paper, or image"); opt-in flows (transcribe, exports, query, add-watch, hooks, update, merge) are properly split out. It falls short of a 5 because the main body is a ~600-line runbook rather than an overview — the Step B0–B3.5 cache choreography is dense enough to belong in its own reference.

4 / 5

Total

16

/

20

Passed

Description

80%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 clearly states capabilities and explicit trigger conditions in third person, with a smart artifact-based trigger (graphify-out/) for the query fast path. Its main weakness is the overly broad "any question about a codebase" clause, which invites triggering on routine code questions that plain text search would answer faster.

DimensionReasoningScore

Specificity

"Turns any input (code, docs, papers, images, videos) into a persistent knowledge graph with god nodes, community detection, and query/path/explain tools" lists several concrete capabilities (graph construction, community detection, query/path/explain tools), matching the 'several specific actions; minor gaps in coverage' anchor; it omits outputs like the HTML viz, GraphRAG JSON, and audit report, so it is not comprehensive enough for a 5.

4 / 5

Completeness

It explicitly answers both parts: what ("Turns any input... into a persistent knowledge graph with god nodes, community detection, and query/path/explain tools") and when ("Use for any question about a codebase, its architecture, file relationships, or project content — especially when graphify-out/ exists"), in third person with concrete trigger phrases, matching the top anchor exactly. Not a 4 because the 'when' clause is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

"any question about a codebase, its architecture, file relationships, or project content" plus "especially when graphify-out/ exists" gives good natural-term coverage and a distinctive artifact-based trigger, but common variations like "code structure", "dependencies", or "how does X work" are missing, so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The knowledge-graph niche and graphify-out/ trigger are distinctive, but "any question about a codebase... or project content" is an aggressively broad trigger that overlaps with ordinary code-search/exploration skills, matching "somewhat specific but could still overlap with similar skills". Not a 4: the breadth of the trigger clause creates real misfire risk beyond "minor overlap with closely related skills".

3 / 5

Total

16

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (805 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/skills/graphify/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.