CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

notion-research-documentation

Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.

64

Quality

80%

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/notion/skills/notion-research-documentation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-organized, token-efficient overview with concrete tool-call guardrails and a clear sequenced workflow. Its critical weakness is that every progressive-disclosure pointer (reference/ guides, templates, examples/) targets files that are absent from the bundle, so the promised detail layer is missing entirely.

Suggestions

Add the referenced files to the bundle (reference/citations.md, reference/format-selection-guide.md, reference/advanced-search.md, the four templates, and the examples/ walkthroughs) or remove those references — currently every pointer is dangling.

Inline a minimal example of a Notion:search query and a notion-create-pages payload so the gather/create steps remain executable even if the template files are absent.

Consolidate the Quick start and Workflow sections, which repeat the same five steps, to reduce duplication and reclaim tokens.

DimensionReasoningScore

Conciseness

The body is lean and information-dense — no padding explaining what Notion is, and the guardrails convey non-obvious schema facts (e.g., 'The current deployed schema expects both top-level fields even when one is unused'). The main trimmable redundancy is the Quick start section previewing the same five steps as the Workflow section. Not 5 because of that duplication; not 3 because there is no unnecessary concept explanation and nearly every line adds operational value.

4 / 5

Actionability

Concrete tool names throughout (`Notion:search`, `Notion:fetch`, `Notion:notion-create-pages`, `Notion:notion-update-page`) with specific parameter guidance ('include `filters: {}`', 'explicit `parent` and a `pages` array', '`update_properties` with `content_updates: []`') and explicit error handling for missing tools. Not 5 because steps 3-4 depend on templates in `reference/` that are not in the bundle, and no example search query or create payload is given inline. Not 3 because the guidance given is executable, not pseudocode or high-level hints.

4 / 5

Workflow Clarity

Steps 0-5 are clearly sequenced with checkpoints (confirm scope with the user, 'ask the user to confirm if multiple results appear'), plus a recovery path for unavailable tools (pause, connect app, retry). Not 5 because there is no final verification step (e.g., checking the created page or that citations resolved). Not 3 because the checkpoints are explicit, not implicit, and the tool-not-found fallback is a real feedback loop.

4 / 5

Progressive Disclosure

The body points to `reference/` files (citations.md, format-selection-guide.md, advanced-search.md, four templates) and `examples/` walkthroughs, but neither directory exists in the bundle — only `assets/` images (which are unreferenced) are present. Per the guideline to score against the actual bundle structure, the split between overview and detail is broken: the referenced detail layer is entirely missing, so navigation fails at every pointer. Not 3 because the in-body signaling is good and would score well if the files existed; the failure is structural, leaving the skill effectively without its referenced detail files.

2 / 5

Total

14

/

20

Passed

Description

87%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: concise, third-person, with an explicit trigger clause naming the domain, the operation, and the concrete output types with citations. The only minor improvement would be adding a few more natural synonyms users might say (summarize, research summary).

DimensionReasoningScore

Specificity

Names the domain and several concrete actions and outputs ("Research across Notion and synthesize into structured documentation", "produce briefs, comparisons, or reports with citations"), but the core verbs 'research' and 'synthesize' stay generic, so coverage is not comprehensive. Not 3 because multiple specific actions and output types are listed; not 5 because it lacks the breadth of the top anchor's fully enumerated concrete operations.

4 / 5

Completeness

Explicitly answers both: what ("Research across Notion and synthesize into structured documentation") and when ("use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations") with concrete trigger phrases. This matches the anchor-5 example pattern of capabilities followed by an explicit 'Use when' clause; nothing is left implied.

5 / 5

Trigger Term Quality

Natural trigger terms are present: "Notion", "gathering info from multiple Notion sources", "briefs", "comparisons", "reports", "citations". A few common phrasings users would say are missing (e.g., 'summarize', 'research summary', 'notes'/'wiki', 'documentation'), so it falls just short of the comprehensive anchor 5 but above anchor 3's missing-synonyms level.

4 / 5

Distinctiveness Conflict Risk

"Notion" scoping gives a clear niche with distinct triggers (Notion sources, cited briefs/comparisons/reports), so it is unlikely to fire for generic document or research tasks. Confirmed against anchor 4: there is no meaningful overlap risk with closely related skills since the Notion-source requirement is stated explicitly.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

openai/plugins

Path

plugins/notion/skills/notion-research-documentation/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.