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, or workspace 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

The canonical home for this skill is paseo-plugin in getpaseo/paseo

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 strong, highly actionable manual: executable code and exact commands for every contribution type, with explicit permission gating and validation/retry checkpoints for risky operations. Its main costs are token weight and monolithic inline content — trimming the longest worked examples and the discursive publishing guidance, or moving them to reference files, would push it to the top tier.

Suggestions

Trim the Publishing a listing section to the essential requirements (OVERVIEW.md contract and ordering) and defer the registry-stopgap migration detail to the linked publishing doc, which is already fetched for contract changes.

Replace the full ~60-line composer-pill subscription example with a minimal registration snippet plus a pointer to the plugin-examples repo, matching how other contribution sections stay compact.

Move the complete worked examples for the larger contribution types (attachment source, timeline transformer/renderer) into a references/ bundle file and keep one compact pattern per section inline in SKILL.md.

DimensionReasoningScore

Conciseness

The body is dense with Paseo-specific contracts Claude cannot know (import boundaries, cleanup semantics, requirements.paseo, the mobile audit, host trust) and explains no general concepts. However, at ~736 lines it inlines material that could be trimmed or externalized, e.g. the ~60-line composer-pill subscription example and the discursive Publishing section that restates the OVERVIEW.md/README distinction and stopgap rule across multiple paragraphs. This fits 'efficient with minor instances that could be trimmed' (4) better than 'every token earns its place' (5).

4 / 5

Actionability

Guidance is fully executable throughout: copy-paste-ready TSX/TS examples for every contribution type, exact CLI invocations ('paseo plugin init', 'npm run typecheck', 'paseo plugin install npm:@acme/paseo-review@1.2.0', 'paseo plugin logs my-plugin --json'), a runnable audit command (rg -n "document\.|window\.|...|className=|onClick=" client/), and a Common failures diagnostic table. Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with explicit validation checkpoints and feedback loops: the enable-plugins procedure (check pluginsEnabled, stop for explicit permission with a quoted warning, set the field, 'paseo reload --json', require pluginsEnabled in appliedPaths, verify the plugin reaches running) and 'Verify the outcome' (typecheck, install/reload the exact ID, require running, check both layouts and themes, exercise error states). A retry loop exists for failed reloads (inspect plugin ls and logs, fix, typecheck, reload again). The risky trusted-code operation is gated by permission checks, so the validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist; all content is inline in SKILL.md. Structure is good: a contribution table mapping each feature to its reference section and example repo, per-feature sections, and clearly signaled one-level-deep external references (paseo.sh doc pages annotated with their contents, plugin-examples repos). But a 736-line single file inlines substantial worked examples and the full publishing listing contract that could live in reference files, which keeps it at 'good structure with minor organization gaps' (4) rather than the well-split top anchor (5).

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: third-person, concise, and comprehensive. It pairs a clear statement of what the skill does with an exhaustive, naturally worded 'Use when' trigger list covering every plugin contribution type, and stays tightly scoped to Paseo so conflict risk is minimal.

DimensionReasoningScore

Specificity

The description enumerates over a dozen concrete, distinct actions ('create, edit, install, reload, enable, disable, remove, or troubleshoot a Paseo plugin; add lifecycle hooks; transform agent configuration, environment, MCP servers... contribute a theme... add plugin RPCs') with comprehensive coverage of the domain. It matches the anchor for multiple specific concrete actions with no evident coverage gaps, and uses third-person voice throughout.

5 / 5

Completeness

'Build and manage trusted local Paseo plugins' states the what, followed by an explicit 'Use when the user asks to...' clause enumerating concrete trigger phrases for the when. Both what and when are clearly and explicitly answered with concrete triggers.

5 / 5

Trigger Term Quality

Trigger terms mirror the exact natural phrases a user would say for each contribution type: 'create... install, reload, enable, disable, remove, or troubleshoot a Paseo plugin', 'slash commands', 'theme', 'timeline items', 'permissions', 'follow-ups'. Coverage includes operation verbs and all sub-feature names (Command Center items, composer pills, attachment sources), matching the comprehensive synonym/variant anchor.

5 / 5

Distinctiveness Conflict Risk

Every clause is scoped to 'Paseo plugin(s)', a distinct niche with domain-specific triggers, so the risk of firing for an unrelated skill is minimal. It matches the clear-niche anchor rather than the minor-overlap anchor (4), since no generic wording like 'plugins' or 'extensions' appears unqualified.

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 (736 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/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.