CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-with-sources

Investigate a topic against preserved sources and write a draft-status research article under `research/` in a Knowledge Base project (the `knowledge-base` starter pack). Read when asked to research a topic, compare options, synthesize sources, gather evidence, or extend an existing research doc. Carries the full procedure: scan existing coverage, agree a research rubric, capture every source verbatim before analyzing, write the article incrementally so a crash never loses work, cite every claim, and link it back into the graph. Does not promote findings to canonical knowledge — that is the sibling `consolidate-notes` skill, after a decision lands.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally clear, gated workflow with copy-paste-ready commands, templates, validation checkpoints, and crash-recovery guidance — top marks for actionability and workflow clarity. Its main weakness is redundancy: several hard rules are restated three times, and the Non-goals section duplicates inline guidance, inflating token cost without adding information.

Suggestions

State the crash-safe persist rule once in 'Persist as you go' and reference it from Steps 4 and 5 with a one-line pointer instead of re-explaining it in full each time.

Drop or compress the Non-goals section to a short list of one-line pointers, since each rule is already enforced with full rationale at its step (e.g., ingest discipline in Step 3, scan requirement in Step 1, scoping gate in Step 2).

Consider moving the article frontmatter spec, article skeleton, and recap template into a reference file (e.g., references/templates.md), keeping SKILL.md a lean procedural overview that loads the templates only at write time.

DimensionReasoningScore

Conciseness

The body is all procedure with no concept-explanation padding, but key rules are stated repeatedly: the crash-safe persist rule appears in near-identical prose in "Persist as you go", Step 4, and Step 5; supervised/headless guidance repeats beyond the mode table in Steps 1, 2, and 8; and the Non-goals section restates six rules already enforced inline ("An article without preserved sources is opinion" appears twice). Not a 2: the bulk is lean, actionable instruction rather than padded explanation; not a 4: several sections are demonstrably trimmable to a single statement of each rule.

3 / 5

Actionability

Fully executable guidance throughout: exact commands (`exec("grep -rln <topic-keyword> <content-dir>")`, `audit({ path: "<doc-path>.md" })`), a copy-paste TaskCreate list, a complete scoping-rubric template, exact frontmatter YAML, a full article skeleton, and a concrete recap template. Not a 4: the templates and commands cover the common cases end-to-end with no missing key details.

5 / 5

Workflow Clarity

A 9-step mandatory execution order with hard gates, task checkpoints (Step 0), a routing decision table (Step 1), a validation checklist (Step 7) with an audit-then-fix-every-finding feedback loop, crash-resume recovery in Step 5, and explicit Path B/C and headless/supervised variants. Not a 4: validation steps, error-recovery loops, and checklists are all explicitly present, matching the top anchor.

5 / 5

Progressive Disclosure

The body is well-sectioned (one section per step, clear headers), and the ingest procedure is properly delegated to the platform skill — "it lives in the platform `/open-knowledge` skill at `references/ingest-and-sources.md`, not in this pack" — a clearly signaled, one-level-deep reference; no bundle files of its own exist to verify. Not a 5: the ~370-line monolith inlines content (templates, routing scripts, mode table) that could be split into reference files for a lighter overview; not a 3: the single reference is clearly signaled and the structure is consistently well-organized.

4 / 5

Total

17

/

20

Passed

Description

88%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 what the skill does, when to use it with natural trigger phrases, and explicitly disambiguates it from the sibling consolidation skill. Minor improvements possible in synonym coverage for trigger terms.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions covering the full procedure: "scan existing coverage, agree a research rubric, capture every source verbatim before analyzing, write the article incrementally so a crash never loses work, cite every claim, and link it back into the graph" — comprehensive coverage with no material gaps. Not a 4: the action list spans the entire workflow end-to-end, not just several steps with minor gaps.

5 / 5

Completeness

Explicitly answers both what ("Investigate a topic against preserved sources and write a draft-status research article under `research/`...") and when ("Read when asked to research a topic, compare options, synthesize sources, gather evidence, or extend an existing research doc") with concrete trigger phrases. Not a 4: the when-clause enumerates specific triggers rather than a generic "use when working with".

5 / 5

Trigger Term Quality

Good natural-phrase coverage in "Read when asked to research a topic, compare options, synthesize sources, gather evidence, or extend an existing research doc" — five phrasings users would actually say. Not a 5: common synonyms like "look into", "dig into", "survey", or "what are the options for X" are missing; not a 3: the present terms are varied and natural rather than generic keywords.

4 / 5

Distinctiveness Conflict Risk

Clear niche (provisional research articles in a Knowledge Base project) with an explicit boundary — "Does not promote findings to canonical knowledge — that is the sibling `consolidate-notes` skill". Not a 5: the broad trigger "research a topic" could overlap with other research/analysis skills outside the knowledge-base pack; not a 3: the sibling disambiguation and project scoping keep overlap risk minor.

4 / 5

Total

18

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing, 3 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository

inkeep/open-knowledge

Path

packages/server/assets/skills/packs/knowledge-base/research/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.