CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

semantica

Semantica full-stack knowledge graph skill for context graphs, decision intelligence, explainability, extraction, reasoning, visualization, ontology, provenance, policy, and export workflows.

Quality

52%

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 ./.claude/skills/semantica/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

32%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 clean, well-sectioned trigger/index document, but it is all index and no content: it never tells Claude how to actually perform any of the eleven capability areas it lists, and its pointers to 'additional files or scripts' are dangling since the bundle contains none. It works as a router for a skill bundle that doesn't exist yet.

Suggestions

Add a minimal concrete quick-start for the most common task (e.g., an example entity/relation extraction prompt-to-output pattern, or the exact command/script to ingest a file), so Claude knows what to do first rather than only when to load the skill.

Either create the referenced reference files (e.g., references/extraction.md, references/reasoning.md) and link them explicitly per topic, or remove the mentions of 'additional files or scripts' since the bundle contains none.

Cut the duplication between the intro, 'When to use this Skill', and 'What this Skill contains' into a single trigger list plus a one-line capability summary, and drop the 'Authoring note' meta-commentary.

For ingestion/dedup/merge workflows (batch operations that mutate the graph), add an explicit validate-before-merge checkpoint so workflow clarity is not capped.

DimensionReasoningScore

Conciseness

The body is short and free of concept explanations Claude already knows, but it is padded with redundancy: the intro sentence, 'When to use this Skill', and 'What this Skill contains' repeat nearly the same domain list three times, and the 'Authoring note' is meta-commentary that earns no tokens. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; not a 2 because no background concepts are explained and each section is individually brief.

3 / 5

Actionability

The body only describes what the skill covers ('Semantic extraction guidance for NER, relation extraction...', 'Deduplication support for duplicate detection...') and never instructs how to do anything — no code, no commands, no example workflows, and no pointers to actual reference files. This matches 'Entirely vague or abstract; no concrete code or commands; only describes rather than instructs'; it is not a 2 because even high-level executable hints (which tool, which script, which file to open) are absent.

1 / 5

Workflow Clarity

'How Claude should use this Skill' gives a rough 3-step sequence, but it is meta-process about loading the skill rather than about performing any graph task, and the steps are poorly defined ('choose the right workflow') with no validation checkpoints for risky batch operations like ingestion and duplicate merging. This matches 'Rough sequence present but many gaps; steps poorly defined; validation absent'; not a 1 because a numbered sequence does exist and is coherent.

2 / 5

Progressive Disclosure

The body is well organized into clearly labeled sections, and no bundle files exist (references/, scripts/, assets/ are absent), so the simple-skill exception applies; however, it repeatedly points to 'additional files or scripts' and 'extra reference files' that do not exist in the bundle, which is a minor organization gap. This matches 'Good structure; most content is appropriately placed; minor organization gaps'; not a 5 because the dangling references to nonexistent files undermine navigation.

4 / 5

Total

10

/

20

Passed

Description

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

The description identifies a distinct niche (Semantica knowledge graphs) with relevant domain keywords, but it is a noun-heavy domain listing rather than a statement of concrete capabilities, and it completely lacks a 'use when' trigger clause. Rewriting it around specific actions with an explicit trigger clause would move it from middling to strong.

Suggestions

Rewrite the description around concrete actions in third person, e.g., 'Extracts entities, relations, and events into a knowledge graph; runs context-graph analytics and decision-intelligence reports; traces provenance; validates ontologies; exports to JSON, RDF, and GraphML.'

Add an explicit trigger clause, e.g., 'Use when the user mentions Semantica, knowledge graphs, triplets, SPARQL, ontology modeling, or graph provenance.'

Include natural synonyms and file extensions users would actually say (triplets, entities, relations, RDF, .ttl, graph database) to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ("full-stack knowledge graph skill") and enumerates many sub-areas ("context graphs, decision intelligence, explainability, extraction, reasoning, visualization, ontology, provenance, policy, and export workflows") but contains almost no concrete actions — no verbs describing what it actually does (e.g., extract entities, ingest data, export to RDF). This matches the anchor 'Names the domain but actions are minimal or generic'; it is not a 1 because the domain list is specific, and not a 3 because no 1-2 concrete actions are explicitly stated.

2 / 5

Completeness

The 'what' is present but only as a domain enumeration rather than a statement of actions, and the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is reasonably clear (knowledge graph capabilities across listed areas).

3 / 5

Trigger Term Quality

Terms like "knowledge graph", "extraction", "reasoning", "provenance", "ontology", and "export" are phrases users would plausibly say, but common variations and synonyms are missing (e.g., triplets, SPARQL, entities/relations, graph database, .ttl/RDF files). This matches 'Some relevant keywords but missing common variations or synonyms'; not a 4 because coverage lacks natural synonyms and file extensions.

3 / 5

Distinctiveness Conflict Risk

The named "Semantica" product and the knowledge-graph niche give it a clear identity with mostly distinct triggers, though broadly stated areas like "visualization" and "export workflows" could overlap with generic graph-visualization or data-export skills. This matches 'Mostly distinct; minor overlap risk with closely related skills'; not a 5 because terms like "visualization" and "export" are not uniquely Semantica.

4 / 5

Total

12

/

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

semantica-agi/semantica

Path

.claude/skills/semantica/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.