CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paseo-plugin

Build and manage trusted local Paseo plugins. Use when the user asks to create, edit, install, reload, enable, disable, remove, or troubleshoot a Paseo plugin; add lifecycle hooks; transform agent configuration, environment, MCP servers, or workspace creation; automate permissions or turn follow-ups; add a screen, sidebar header or footer item, workspace panel, or file panel; add Command Center items or slash commands; add composer pills or attachment sources; transform, render, or append agent timeline items; contribute a theme; use Paseo from plugin code; or add plugin RPCs.

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

A dense, highly executable reference that assumes Claude's competence and adds only Paseo-specific contracts, with strong validation loops and troubleshooting throughout. Its main weakness is structure: everything lives in one monolithic SKILL.md with no bundle files, relying on external web docs and inline examples rather than split local references.

Suggestions

Move the per-contribution code walkthroughs (composer pills, timeline transformers/renderers, themes, attachment sources) into files under references/ and keep one minimal example per pattern inline, trimming the duplicated theme/layout styling boilerplate from the remaining examples.

Extract the OVERVIEW.md authoring contract and registry-stopgap rules from 'Publishing a listing' into a references/publishing.md and summarize the four content rules in SKILL.md.

Consider moving the 'Common failures' symptom-to-cause list into a references/troubleshooting.md so the verify checklist stays the primary post-change workflow.

DimensionReasoningScore

Conciseness

Nearly every sentence carries Paseo-specific contract detail Claude cannot know (import boundaries, cleanup semantics, host trust model, reload behavior) with no padding about known concepts, and code blocks are complete rather than annotated tutorials. It falls short of anchor 5 because the theme/layout styling boilerplate (e.g. `padding: layout.compact ? 16 : 24`, `backgroundColor: theme.colors.surface0`) is repeated across the panel, screen, and pill examples, and the registry-stopgap rules in 'Publishing a listing' run long. These are still minor instances of over-length relative to the whole, fitting anchor 4 rather than dropping to anchor 3's 'some unnecessary explanation'.

4 / 5

Actionability

Every section provides copy-paste-ready material: `paseo plugin init`, `npm install`, the full install/update/ls/reload/logs command list, complete client/server/shared TypeScript for each contribution type, a concrete `rg` audit command for the mobile checklist, and per-symptom debugging steps. This matches anchor 5 ('fully executable; copy-paste ready code or commands; specific examples cover the common cases'); anchor 4's 'minor gaps' does not apply since even error states and the enable-permission workflow are fully specified.

5 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints and feedback loops: typecheck before install/reload, the global-switch procedure requiring `pluginsEnabled` in `appliedPaths` or a re-read confirmation, `paseo plugin ls` requiring `running`, and a failed-reload loop (inspect `plugin ls`/`plugin logs`, fix, typecheck, reload again). The 'Verify the outcome' checklist and 'Common failures' symptom-to-cause list match anchor 5's 'explicit validation steps; feedback loops for error recovery; checklists', and the destructive install/enable operations all carry validation, so no cap applies.

5 / 5

Progressive Disclosure

Navigation is genuinely good — the contributions table routes each request type to a specific external reference section and example repo, and every doc link (publishing, reference.md sections, migration guide) is one level deep and clearly signaled. It does not reach anchor 5 because nothing is split into bundle files: a 735-line body inlines full walkthroughs (pills, timeline, themes, the publishing contract) that belong in local reference files, and the skill doubles as the offline fallback for the entire public docs. It sits above anchor 3 since references are clearly signaled and organized, not buried or merely 'could be' separate.

4 / 5

Total

18

/

20

Passed

Description

100%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.

An exemplary description: it states what the skill does in one sentence and then exhaustively enumerates natural trigger phrases for every contribution type, lifecycle task, and management operation. It is long but every clause is a distinct trigger, not padding.

DimensionReasoningScore

Specificity

"Build and manage trusted local Paseo plugins" plus an enumeration of concrete actions — create, edit, install, reload, enable, disable, remove, troubleshoot; add lifecycle hooks; add screens, sidebar items, workspace/file panels, Command Center items, slash commands, composer pills, attachment sources, themes, timeline items, and plugin RPCs — gives comprehensive coverage with no generic filler. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and exceeds anchor 4 because coverage of the plugin surface area is essentially exhaustive rather than having minor gaps.

5 / 5

Completeness

The 'what' is explicit up front ("Build and manage trusted local Paseo plugins") and the 'when' is explicit and concrete ("Use when the user asks to create, edit, install, ... or add plugin RPCs"), answering both questions with concrete trigger phrases. This is the anchor-5 pattern; anchor 4 ('when' could be more explicit or specific) clearly understates the enumerated trigger list.

5 / 5

Trigger Term Quality

Phrases like "slash commands", "workspace panel", "sidebar header or footer item", "composer pills", "attachment sources", "contribute a theme", and "troubleshoot a Paseo plugin" are exactly what a user would say, with synonyms covered (Command Center items / ⌘K actions; screens / panels; timeline transform / render / append). It matches anchor 5's comprehensive natural-term coverage; the only missing pattern is file extensions, which have no natural equivalent for plugins, so it is not merely 'a few natural terms missing' (anchor 4).

5 / 5

Distinctiveness Conflict Risk

"Paseo plugin" is repeated as the object of every trigger, establishing a clear niche that would not fire for generic plugin, MCP, or IDE-extension requests. Minimal conflict risk as in anchor 5; it does not fall to anchor 4 because there is no meaningful overlap with a closely related skill's triggers.

5 / 5

Total

20

/

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

skill_md_line_count

SKILL.md is long (737 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

getpaseo/paseo

Path

skills/paseo-plugin/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.