CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

86

1.36x
Quality

81%

Does it follow best practices?

Impact

89%

1.36x

Average score across 7 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-sequenced with a strong MCP failure-recovery loop, but it is held back by Quick-start/Workflow redundancy and by progressive-disclosure references to template and example files that are not actually bundled.

Suggestions

Create the referenced reference/ files (citations.md, format-selection-guide.md, and the brief/summary/comparison/comprehensive templates) and the examples/ walkthroughs, or remove the references — the progressive-disclosure pointers currently resolve to nothing.

Collapse the overlapping Quick start and Workflow step lists into a single sequenced procedure to remove redundancy and tighten token use.

Add an explicit 'review draft against sources before publishing' validation checkpoint in the Synthesize/Create stages to round out the workflow's feedback loops.

DimensionReasoningScore

Conciseness

Mostly lean bullets with no concept over-explanation, but the Quick start and Workflow sections re-cover the same five steps (search → fetch → format → create → cite), so it could be tightened rather than earning the 'every token earns its place' top anchor.

2 / 3

Actionability

Concrete tool calls (Notion:notion-search/fetch/create-pages/update-page) and setup commands are copy-paste ready, but the drafting guidance relies on template files in reference/ that are not actually bundled, leaving key details incomplete.

2 / 3

Workflow Clarity

Clearly numbered sequence with an explicit error-recovery feedback loop (Step 0: MCP call fails → add MCP → login → restart → retry) and a user-confirmation checkpoint on ambiguous search results, fitting the clear-sequence-with-feedback anchor.

3 / 3

Progressive Disclosure

The overview is well-organized and clearly signals one-level-deep references (reference/*.md, examples/*.md), but those referenced files do not exist in the bundle — only unreferenced assets/ images are present — so the disclosure structure is promised but not delivered.

2 / 3

Total

9

/

12

Passed

Description

100%

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 is well-crafted: concrete actions, an explicit 'use when' trigger, third-person voice, and a distinct Notion-research niche. It satisfies every dimension anchor at the top level.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Research across Notion,' 'synthesize into structured documentation,' and 'produce briefs, comparisons, or reports with citations' — matching the multi-action top anchor rather than the single-action level 2 example.

3 / 3

Completeness

Explicitly states what it does ('Research across Notion and synthesize into structured documentation') and when to use it ('use when gathering info from multiple Notion sources...'), answering both what and when; it is not the level-2 case where 'when' is only implied.

3 / 3

Trigger Term Quality

Includes natural user terms ('Notion,' 'briefs,' 'comparisons,' 'reports,' 'citations,' 'gathering info') inside an explicit 'use when' clause, giving good coverage of phrases a user would actually say.

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche (multi-source Notion research → cited documentation) with Notion-specific triggers unlikely to fire for unrelated skills, rather than the generic, conflict-prone level-1/2 examples.

3 / 3

Total

12

/

12

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.

Validation14 / 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/skills
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.