CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

knowledge-graph

Compile documents, notes, web content, transcripts, research materials, or code repositories into an evidence-grounded, visualization-ready knowledge graph with semantically typed entity nodes, statement-level provenance, and typed relationship edges. Use with ov compile to create or incrementally refresh `entities/*.md` node artifacts and a root `relations.jsonl` edge file for people, organizations, groups, animals, places, products, projects, systems, services, modules, datasets, standards, documents, events, and other identifiable things.

74

Quality

93%

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 knowledge-graph in volcengine/OpenViking

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 a strong, highly actionable instruction set: concrete formats, templates, naming conventions, a four-phase workflow, and a thorough validation checklist, with no filler or explanations of known concepts. The main weaknesses are mild redundancy (inverse-edge rules stated twice, checklist restating body rules) and the absence of an explicit fix-and-revalidate loop after the quality check. Those keep conciseness, workflow clarity, and progressive disclosure at 4 rather than 5.

Suggestions

Consolidate the duplicate inverse-edge guidance into a single rule (merge the 'Add reciprocal or inverse edges' bullet into the 'Use inverse edges selectively' paragraph) to remove the conciseness redundancy.

Add one feedback-loop line to the Quality check section, e.g. 'If any check fails, fix the affected nodes or edges and re-run the full checklist before finishing', to make error recovery explicit and raise workflow clarity.

Consider moving the Display contract (and optionally the detailed ID-localization rules) into a one-level-deep reference file so SKILL.md stays a leaner operational overview.

DimensionReasoningScore

Conciseness

The body is almost entirely operational rules and templates with no explanation of concepts Claude already knows, but it contains avoidable redundancy: inverse-edge guidance appears twice ('Add reciprocal or inverse edges when they carry useful, source-supported meaning' in the Typed edges list and again in the standalone 'Use inverse edges selectively' paragraph), and the Quality check section restates many body rules. Not 5 because some tokens (the duplicated inverse-edge rules and repeated checklist items) do not earn their place; not 3 because there is no padding or over-explanation of known material.

4 / 5

Actionability

The guidance is fully executable: exact artifact tree, a copy-paste-ready node frontmatter template, a concrete JSONL edge example ('{"from":"孙悟空","relation":"member_of",...}'), explicit ID and predicate conventions (lowercase snake_case, kebab-case IDs, sort by from/relation/to), and a specific error-recovery rule for merged duplicates ('rewrite all affected edge endpoints to the surviving entity ID'). Not 4: the templates and conventions cover the common cases with no notable gaps.

5 / 5

Workflow Clarity

The Workflow section defines a clear Survey → Normalize → Extract → Integrate sequence, and the Quality check section provides an explicit, comprehensive pre-finish validation checklist ('Before finishing, verify that: every node has matching file and frontmatter IDs...'), so the batch-operation validation cap does not apply. Not 5: no explicit fix-and-revalidate feedback loop is written (what to do when a quality check fails is left implicit), which is the minor validation gap of the 4 anchor.

4 / 5

Progressive Disclosure

The single file is well organized with clear, navigable sections (Goal, Entity nodes, Typed edges, Provenance, Display contract, Workflow, Quality check) and no nested or dead references. Not 5: at ~225 lines of dense rules the SKILL.md is more than a lean overview — secondary material such as the Display contract and the detailed ID-localization rules could live one level deep in a reference file to keep the main file a tighter overview; not 3 because nothing clearly requiring separation (bulk API reference, etc.) is inlined.

4 / 5

Total

17

/

20

Passed

Description

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

This is an exemplary description: it states concrete capabilities with exact artifact paths, includes an explicit 'Use with...' trigger clause, enumerates natural synonyms and file extensions, and defines a distinct niche. It follows the strongest reference-example pattern (what + when with concrete triggers) without padding or buzzword-only claims. No changes needed.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Compile documents, notes, web content, transcripts, research materials, or code repositories into an evidence-grounded, visualization-ready knowledge graph' and 'create or incrementally refresh `entities/*.md` node artifacts and a root `relations.jsonl` edge file' — covering inputs, outputs, and refresh behavior comprehensively. Not 4: there are no coverage gaps; input kinds, output artifacts, and node/edge semantics are all enumerated.

5 / 5

Completeness

The 'what' is explicit (compile sources into a typed knowledge graph producing entity node artifacts and a relations.jsonl edge file) and the 'when' is an explicit trigger clause: 'Use with ov compile to create or incrementally refresh `entities/*.md` node artifacts and a root `relations.jsonl` edge file'. Not 4: the use clause is concrete and specific rather than one that 'could be more explicit'.

5 / 5

Trigger Term Quality

Natural user terms are comprehensively covered with synonyms ('documents, notes, web content, transcripts, research materials, or code repositories', 'knowledge graph', 'people, organizations, groups... places, products, projects') plus file extensions ('.md', '.jsonl'). Not 4: the missing-terms gap of the 4 anchor does not apply — both natural phrasing and artifact extensions are present.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — building typed knowledge graphs ('semantically typed entity nodes, statement-level provenance, and typed relationship edges') tied to a specific tool invocation ('Use with ov compile') and specific artifact paths. Not 4: overlap risk with generic document or note-processing skills is minimal because the output form and trigger are distinctive.

5 / 5

Total

20

/

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

volcengine/OpenViking

Path

openviking/system_assets/compile/example-skills/knowledge-graph/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.