CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

extract

Run the full Semantica semantic extraction pipeline on a file or selected text — NER, relations, events, coreference resolution, triplets, and validation. Clears result cache before each run. Returns Markdown tables with entity/relation/event/triplet results and inline validator warnings.

Quality

81%

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

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.

A lean, highly actionable skill body: a six-step workflow with copy-paste-ready Python for every pipeline stage, exact output table schemas, and sensible operational details (cache clearing, chunking for >50KB files, in-graph entity tagging). The residual gaps are minor — no error handling for unreadable inputs, no mapping from result objects to table columns, and validation coverage that skips events and triplets.

Suggestions

Show how to populate the table columns (e.g., the attribute names on entity/relation objects like `entity.label`, `entity.confidence`) so the Markdown-table step is fully copy-paste ready.

Add a brief error path for step 1 (what to do when $ARGUMENTS names an unreadable path) to round out the workflow's validation checkpoints.

Extend `validator.validate(...)` to cover events and triplets, or note explicitly that validation applies to entities and relations only.

DimensionReasoningScore

Conciseness

The body contains no concept explanations Claude already knows and no padded sections; comments are limited to non-obvious operational notes ("Clear the result cache to prevent cross-invocation pollution", "resolve pronouns/aliases before extraction"). Every section (steps, code, table formats, summary line) earns its tokens, matching the score-5 anchor "Lean and efficient; assumes Claude's competence".

5 / 5

Actionability

The pipeline code block is concrete and executable for all six stages (NamedEntityRecognizer through ExtractionValidator), and output formats are precisely specified. Minor gaps keep it at the score-4 anchor: `open(path).read()` is shorthand rather than complete code, no mapping is shown from result objects to the table columns (Label/Type/Confidence/Span), and `validator.validate(entities, relations)` omits events and triplets. Not score 3 — the guidance is genuinely executable, not pseudocode.

4 / 5

Workflow Clarity

Six numbered steps give a clear sequence with explicit checkpoints: cache clearing before the run (step 2) and validator warnings reported above results (step 4). The operation is read-only, so no fix-and-retry feedback loop is required, but there is no error path for an unreadable file path or a failed import, and the validation step reports without any disposition guidance — matching score 4 ("Clear sequence with most checkpoints present; minor validation gaps") rather than score 5's explicit error-recovery loop.

4 / 5

Progressive Disclosure

The body is well-organized with a usage header, a Steps section, and clearly specified output formats, and no bundle files exist (references/, scripts/, assets/ are absent), so nothing is inlined that belongs elsewhere and no dangling references exist. At ~88 lines with the full API usage inline it sits just above the lean-overview ideal of the score-5 anchor (which also assumes <50 lines or one-level-deep reference files), fitting score 4 ("Good structure; most content is appropriately placed").

4 / 5

Total

17

/

20

Passed

Description

71%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 highly specific, third-person description that comprehensively catalogs the pipeline's capabilities and output format. Its main weakness is the complete absence of a "Use when..." trigger clause, which both caps completeness and leaves the user-facing activation scenario implicit. Trigger-term coverage is solid but lacks natural synonyms beyond the technical vocabulary.

Suggestions

Append an explicit trigger clause, e.g., "Use when the user asks to extract entities, relations, events, or triplets from text, or mentions semantic extraction, NER, or coreference."

Add natural synonyms alongside the technical terms ("named entities", "who did what to whom", "knowledge graph triplets") so the description matches phrasings users actually say.

State when to use this versus plain text extraction (e.g., structured semantic analysis vs. raw text) to further reduce overlap risk with generic document skills.

DimensionReasoningScore

Specificity

Quotes: "Run the full Semantica semantic extraction pipeline on a file or selected text — NER, relations, events, coreference resolution, triplets, and validation" and "Returns Markdown tables with entity/relation/event/triplet results and inline validator warnings." It enumerates every pipeline stage plus output format, cache behavior, and warning reporting — comprehensive concrete coverage matching the score-5 anchor, with consistent third-person voice ("Run", "Clears", "Returns").

5 / 5

Completeness

The description clearly answers "what" ("Run the full Semantica semantic extraction pipeline... NER, relations, events, coreference resolution, triplets, and validation") but contains no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not score 2 because the "what" is fully explicit, and not score 4 because "when" is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

Quotes: "semantic extraction", "NER", "relations", "events", "coreference resolution", "triplets" — good domain keyword coverage, but common natural variations users would say are missing (e.g., "named entities", "who did what to whom", "knowledge graph"). This fits the score-4 anchor ("Good keyword coverage; a few natural terms missing") rather than score 5's comprehensive synonym coverage, and clearly exceeds score 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

Quotes: "Semantica semantic extraction pipeline", "coreference resolution", "triplets" — a clear niche with distinctive technical triggers that most other skills would not claim. Minor overlap risk remains with generic text-extraction or document-analysis skills since no usage context differentiates it, matching score 4 ("Mostly distinct; minor overlap risk") rather than score 5's minimal conflict risk.

4 / 5

Total

16

/

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/extract/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.