CtrlK
BlogDocsLog inGet started
Tessl Logo

microsoft-onenote

Microsoft OneNote integration. Manage Notebooks. Use when the user wants to interact with Microsoft OneNote data.

56

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/microsoft-onenote/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 well-structured and highly actionable, with concrete CLI commands and an explicit connection-state feedback loop. Its main weaknesses are the unnecessary introductory explanation of what OneNote is and the empty Description column in the actions table.

Suggestions

Remove or trim the opening paragraph describing what OneNote is; Claude already knows this and it competes with context for no gain.

Fill the empty Description column in the 'Popular actions' table, or drop the column, so the table conveys actionable meaning instead of names alone.

Add a brief validation/check step before destructive actions (e.g. 'delete-page' / 'delete-notebook') to give the workflow an explicit verify checkpoint.

DimensionReasoningScore

Conciseness

The body is mostly efficient, but the opening paragraph explaining what OneNote is ('a digital note-taking app that allows users to create and organize notes...') is content Claude already knows, and the action table repeats long action names with an empty description column, placing it at 'mostly efficient but includes some unnecessary explanation'.

3 / 5

Actionability

It provides concrete, executable CLI commands throughout (install, login, connection ensure, action list/run, request) with flag tables, which is 'mostly executable guidance with minor gaps' — the gaps being placeholder values like CONNECTION_ID and an empty Description column in the actions table.

4 / 5

Workflow Clarity

The connection setup is a clear sequenced flow with an explicit state-machine feedback loop (BUILDING → poll → READY / CLIENT_ACTION_REQUIRED / error), which is 'clear sequence with most checkpoints present'; it stops short of level 5 because destructive operations like delete-page lack an explicit verify-before-acting checkpoint.

4 / 5

Progressive Disclosure

Content is well organized into clearly signaled sections (Install, Authentication, Connecting, Searching, Popular actions, Running, Proxy, Best practices) with no bundle files to offload, so it is 'good structure; most content appropriately placed' rather than the level-5 anchor that requires well-signaled one-level-deep external references.

4 / 5

Total

15

/

20

Passed

Description

62%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 cleanly names a clear niche and includes an explicit 'Use when' clause, but it relies on the generic verb 'Manage' and offers only surface-level trigger terms without natural synonyms. It is solid but not comprehensive.

Suggestions

Replace 'Manage Notebooks' with concrete actions (e.g. 'create notebooks and sections, list and create pages, copy pages') to lift specificity.

Add natural trigger synonyms users would say, such as 'notes', 'notebook sections', or 'OneNote pages', so it triggers on varied phrasings.

Tighten the 'when' clause with concrete triggers (e.g. 'Use when the user wants to create, read, or organize OneNote notebooks, sections, or pages').

DimensionReasoningScore

Specificity

The description names the domain ('Microsoft OneNote integration. Manage Notebooks.') but 'Manage' is a minimal, generic verb that does not list concrete actions, matching the anchor for naming a domain with 1-2 minimal actions rather than the level-2 anchor whose example is just 'Processes PDF files' (this at least names Notebooks).

3 / 5

Completeness

It states both the 'what' ('Manage Notebooks' integration) and an explicit 'when' ('Use when the user wants to interact with Microsoft OneNote data'), but the trigger guidance is generic ('interact with ... data') rather than concrete triggers, so it is above the level-3 'what without when' anchor but short of the level-5 explicit-concrete-triggers anchor.

4 / 5

Trigger Term Quality

It surfaces 'Microsoft OneNote' and 'Notebooks' as keywords, but offers no natural synonyms or variations a user might say (e.g. 'notes', 'notebook sections', 'pages'), fitting the 'some relevant keywords but missing common variations' anchor rather than the level-4 example with several natural terms.

3 / 5

Distinctiveness Conflict Risk

'Microsoft OneNote integration' carves a clear niche with minimal overlap against other skills, placing it at 'mostly distinct; minor overlap risk with closely related skills' rather than the level-5 anchor which pairs distinctiveness with concrete trigger phrases.

4 / 5

Total

14

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
membranedev/application-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.