CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

notion-knowledge-capture

Transforms conversations and discussions into structured documentation pages in Notion. Captures insights, decisions, and knowledge from chat context, formats appropriately, and saves to wikis or databases with proper organization and linking for easy discovery.

1.41x
Quality

67%

Does it follow best practices?

Impact

96%

1.41x

Average score across 3 eval scenarios

SecuritybySnyk

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./data/06f65bbf-3f3a-4a19-a3c2-46ec20d03f26/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 skill delivers a clear, well-sequenced knowledge-capture workflow with concrete Notion tool names, one fully parameterized update-page example, and useful database property schemas. Its main weaknesses are generic writing-advice padding, absent validation checkpoints for the write operations, and a progressive-disclosure layer that is completely broken — every referenced file is missing from the bundle, leaving the promised database guide and example workflows undeliverable.

Suggestions

Ship the referenced files or remove the links: create references/database-best-practices.md and the three examples/*.md files, or delete the dangling links and keep that content inline — currently every reference in the body 404s.

Add validation checkpoints to the workflow: search before creating to avoid duplicates (currently buried in Common Issues), verify the page was created with expected properties, and confirm the hub-page link landed in the intended section after Notion:notion-update-page.

Cut the generic sections ("Formatting Best Practices", "Best Practices", "Indexing and Organization") that restate documentation wisdom Claude already knows, and merge the three overlapping content taxonomies (Steps 1–2, "Content Types", "Content Extraction from Conversations") into one.

DimensionReasoningScore

Conciseness

The operational core (Quick Start, the 6-step workflow, Destination Patterns with concrete tool names) is Notion-specific and lean, but sections like "Formatting Best Practices" ("use bullets, keep paragraphs short, add examples"), "Best Practices" ("Capture promptly", "Link extensively"), and "Indexing and Organization" restate documentation wisdom Claude already knows, and three overlapping content taxonomies (Steps 1–2, "Content Types", "Content Extraction from Conversations") add redundancy. Not a 2 because the majority of tokens are task-specific rather than padded; not a 4 because several sections could be cut wholesale.

3 / 5

Actionability

Names the exact tool for each step ("Use `Notion:notion-search`", "Use Notion:notion-create-pages", "Notion:notion-update-page"), the Step 6 example shows concrete parameters (page_id, command: "insert_content_after", selection_with_ellipsis, new_str), and Destination Patterns list exact database properties (Title, Type, Category, Tags / Decision, Date, Status, Domain). Falls short of 5 because the central create-pages call is never shown with arguments and the extraction steps are generic checklists; clearly above 3 because the guidance is specific and directly executable in intent.

4 / 5

Workflow Clarity

Quick Start and the detailed 6-step workflow give a coherent, well-defined sequence, but validation checkpoints are implicit at best: no verify-after-create, no confirmation the hub link was inserted correctly, and the "'Already exists': Search first, update existing if appropriate" dedup guidance is tucked into Common Issues rather than the workflow. Since the skill writes to Notion databases and modifies existing hub pages ("Notion:notion-update-page" on "team-wiki-homepage-id"), the missing feedback loops cap this at 3 per the rubric's scoring notes; not a 2 because the sequence itself is clear and complete.

3 / 5

Progressive Disclosure

The bundle contains only SKILL.md — no references/, scripts/, or assets/ directories exist — yet the body points to "[reference/database-best-practices.md](reference/database-best-practices.md) for database selection guide and individual schema files" (linked redundantly under both Destination Patterns and Advanced Features) and to three "[examples/](examples/)" files for "complete workflows"; none of these files exist, so the promised detail is undeliverable. The database property schemas and content-type templates that belong in those files are inlined in a ~200-line body. Not a 3 because the reference layer is not merely unclear — it is entirely broken; not a 1 because the single file itself has clear, well-organized section headers.

2 / 5

Total

12

/

20

Passed

Description

66%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 is specific, third-person, and clearly names its niche (turning conversation content into organized Notion pages), with good natural trigger keywords around conversations, wikis, and databases. Its main gap is the absence of any explicit "Use when..." trigger clause, which caps completeness and leaves invocation timing only weakly implied.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks to save, document, or capture something from the conversation into Notion, or mentions a wiki, knowledge base, decision log, or meeting notes."

Replace the generic "formats appropriately" with concrete actions such as "applies how-to, FAQ, and decision-record templates with appropriate database properties".

Add natural synonyms users would say ("meeting notes", "document this decision", "add to our wiki") to strengthen trigger coverage beyond the current keyword set.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Transforms conversations and discussions into structured documentation pages in Notion", "Captures insights, decisions, and knowledge from chat context", "saves to wikis or databases with proper organization and linking" — naming the target system and the capture/save/organize pipeline. Falls short of anchor 5 because "formats appropriately" is generic filler and coverage has minor gaps; clearly above anchor 3, which covers only 1-2 concrete actions.

4 / 5

Completeness

The 'what' is clearly and concretely answered (transform/capture/format/save/organize), but there is no "Use when..." clause or equivalent explicit trigger guidance — "from chat context" only weakly implies when to invoke the skill. Per the judging guideline, a missing explicit 'when' caps completeness at 3 even with a strong 'what'.

3 / 5

Trigger Term Quality

Contains good natural keywords a user would say: "conversations", "discussions", "knowledge", "insights", "Notion", "wikis", "databases", "chat context". Missing a few common synonyms and phrasings users actually use (e.g., "meeting notes", "document this", "save this to Notion"-style triggers), which keeps it below anchor 5; it exceeds anchor 3 because coverage is broad rather than just "some relevant keywords".

4 / 5

Distinctiveness Conflict Risk

"in Notion" plus "saves to wikis or databases" carves out a clear niche with distinct triggers (Notion, wiki, knowledge capture) that few skills share. Minor overlap risk remains with generic documentation/summarization skills because "structured documentation" and "knowledge" are broad terms, keeping it below anchor 5.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 6 missing

Warning

Total

15

/

16

Passed

Repository

majiayu000/claude-skill-registry-data

Path

data/06f65bbf-3f3a-4a19-a3c2-46ec20d03f26/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.