CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ontology

Manage ontology schemas, concepts, alignments, and SHACL/OWL validation for Semantica knowledge graphs. Uses OntologyEngine and OntologyValidator.

Quality

76%

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 ./plugins/skills/ontology/SKILL.md
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 an exemplary lean, code-first reference: every subcommand has executable snippets with the non-obvious operational caveats (extras, API keys, store requirements) captured in terse comments. The only weaknesses are minor — later sections assume context from earlier ones, SHACLGenerator lacks a usage example, and there are no verification steps or deeper-reference pointers for the output-producing commands.

DimensionReasoningScore

Conciseness

The body is lean and code-first: each subcommand section is a one-line description plus a short snippet, with no explanation of concepts Claude already knows. Comments carry only non-obvious operational facts ("needs semantica[tripletstore-oxigraph]", "raises ProcessingError without one", "LLM-assisted (needs an llm-* extra + API key)") — every token earns its place, matching the 'Lean and efficient' anchor.

5 / 5

Actionability

Each subcommand has concrete, executable Python with real imports, constructor arguments, and expected result attributes (e.g. "result.valid, result.errors, result.warnings"), meeting the 'mostly executable guidance' anchor. It falls short of 5 because later sections (export, align, evaluate) assume an `engine` and `onto` without restating instantiation, and `SHACLGenerator` is named with an import but no usage example.

4 / 5

Workflow Clarity

The skill is a per-subcommand reference where each action is unambiguous and immediately executable, and the validate section surfaces result fields that serve as a check on ontology consistency. It is not a 5 because there are no explicit verification steps for output-producing operations (e.g. confirming an export file was written or handling `from_text` failures), and not a 3 because no section is vague about what to run.

4 / 5

Progressive Disclosure

Sections are cleanly split per subcommand under a clear usage header and entry-point note, with no content that belongs in a separate file — no bundle files exist and each section is short, so nothing is inlined that should be external. It does not reach 5 because the body exceeds the ~50-line simple-skill threshold and offers no pointer to deeper API detail (e.g. a reference file for OntologyEngine's full method surface), leaving a minor organization gap.

4 / 5

Total

17

/

20

Passed

Description

58%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 clearly communicates what the skill does with specific, domain-appropriate capability nouns and named entry-point classes, and it occupies a distinct niche. Its main weakness is the total absence of 'when to use' trigger guidance and the lack of natural-language synonyms a user would actually say, which cap trigger term quality and completeness at 3.

Suggestions

Append an explicit trigger clause, e.g. "Use when working with Semantica ontologies, SKOS vocabularies, or when the user mentions SHACL shapes, OWL consistency, or aligning concepts."

Add natural trigger-term variations users would actually say — "validate", "check consistency", "align vocabularies", "export turtle/OWL" — rather than only formal nouns like "SHACL/OWL validation".

Mention the build-from-text/data and export capabilities so the description's capability coverage matches what the skill body actually offers.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "Manage ontology schemas, concepts, alignments, and SHACL/OWL validation" — which names specific actions beyond a generic domain claim. It stops short of a 5 because build-from-text, export, and evaluation capabilities from the body are absent, leaving minor gaps in coverage.

4 / 5

Completeness

The 'what' is clearly stated (manage schemas, concepts, alignments, SHACL/OWL validation), but there is no 'Use when...' clause or equivalent trigger guidance anywhere. Per the judging guidelines a missing explicit trigger clause caps completeness at 3, and a 4 would require at least an implicit or weakly present 'when', which this lacks entirely.

3 / 5

Trigger Term Quality

Relevant domain keywords are present ("ontology", "SHACL", "OWL", "knowledge graphs", "Semantica") but coverage lacks natural variations users would say — e.g. "validate", "check consistency", "RDF", "turtle", "align vocabularies" — and there are no user-facing trigger phrases. It matches the 'some relevant keywords but missing common variations or synonyms' anchor rather than the anchor above, which expects good keyword coverage with only a few natural terms missing.

3 / 5

Distinctiveness Conflict Risk

The niche is well-defined — Semantica knowledge graphs with SHACL/OWL validation and ontology alignments — making it mostly distinct with only minor overlap risk against other Semantica or RDF/ontology skills. It is not a 5 because "Manage ontology schemas... for Semantica knowledge graphs" could still overlap with sibling Semantica skills without a sharper trigger boundary.

4 / 5

Total

14

/

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

plugins/skills/ontology/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.