CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

notion-digest

Reads recently edited pages from the notion MCP server (read-only) and writes what it found into a Markdown digest in this repo, then opens a pull request with that change. Runs unattended: it asks no questions and makes no writes to notion.

Quality

90%

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

100%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 exemplary skill body: lean, fully executable, and sequenced with explicit stop-and-report checkpoints at every failure mode. It correctly handles the environment-dependent parts (MCP tool names, credentials) with concrete instructions rather than vague direction.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no basic concepts are explained, and every line carries non-inferable operational detail ("Git already has a credential helper and a bot commit identity, so `git push` and `gh pr create` authenticate with no setup"; "Do not write `launch-result.json`"). Nothing reads as padding or over-explanation, matching anchor 5 rather than the 'minor instances that could be trimmed' of anchor 4.

5 / 5

Actionability

The PR section is a fully executable, copy-paste-ready bash block (branch, add, commit, push, `gh pr create` with concrete title and body), and the digest output is concretely specified (heading, UTC time line, newest-first linked bullets, closing count line). Edge cases are handled explicitly — missing credentials and MCP tools each have a defined stop-and-report action, and an empty result is defined as valid — matching anchor 5 with no missing key details.

5 / 5

Workflow Clarity

A clear three-step sequence with explicit checkpoints at each failure point: preflight validation of the MCP server and credentials ("If either is missing, stop and report which one"), tool-name discovery with a defined failure action, empty-result handling, and "Capture the PR URL, then stop." The operation is not destructive or batch (a single-file write on a fresh timestamped branch, with "Re-running is safe" noted), so no cap applies, and the error paths are explicit rather than implicit, matching anchor 5 over anchor 4.

5 / 5

Progressive Disclosure

This is a single-file skill with no bundle directories, and nothing in the body warrants splitting out — all content is essential operational detail. Sections (Inputs, Procedure with numbered steps, Notes) are well-organized and easy to navigate, so under the simple-skill guidance it merits anchor 5 rather than the organization gaps implied by anchor 4.

5 / 5

Total

20

/

20

Passed

Description

75%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 specific, distinctive description with concrete actions and explicit safety constraints, written in proper third-person voice. Its main weakness is the absence of any 'Use when...' trigger clause, which caps completeness and leaves natural synonym coverage thin.

Suggestions

Add an explicit trigger clause, e.g. "Use when a scheduled or unattended run should summarize recent Notion activity as a digest and open a PR."

Include natural synonyms users would say, such as "Notion pages", "summary", or "recap", to broaden trigger-term coverage.

Optionally name the input knobs (digest path, item limit) in the description so the skill's parameterization is discoverable at a glance.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the complete flow — "Reads recently edited pages", "writes what it found into a Markdown digest in this repo", "opens a pull request" — plus explicit behavioral constraints ("read-only", "makes no writes to notion"). Coverage is comprehensive for the skill's domain, matching the anchor 5 example's level of specificity rather than having the 'minor gaps' of anchor 4.

5 / 5

Completeness

The 'what' is clearly and concretely answered, but there is no 'Use when...' clause or equivalent explicit trigger guidance; "Runs unattended" only weakly implies when the skill applies. Per the judging guideline, a missing 'Use when' clause caps completeness at 3 (clear 'what', 'when' missing or weakly implied), and it cannot reach 4 without an explicit 'when'.

3 / 5

Trigger Term Quality

Natural keywords a user would say are present — "notion", "recently edited pages", "Markdown digest", "pull request" — but common variations and synonyms (e.g., "summary", "recap", "changelog", "Notion pages") are missing. This is good keyword coverage with a few natural terms absent, which matches anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche defined by specific triggers — "notion MCP server", "Markdown digest", "pull request" — with nothing generic that would overlap other skills. It matches anchor 5 (clear niche with distinct triggers, minimal conflict risk); anchor 4 would require some overlap risk with closely related skills, which is not the case.

5 / 5

Total

17

/

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

drew-tessl/repo-schedules-test

Path

plugins/mcp-digests/skills/notion-digest/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.