CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paseo

Paseo reference for managing projects, workspaces, workspace scripts, agents, schedules, and heartbeats.

Quality

76%

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 ./.agents/skills/paseo/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

83%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 an exceptionally lean, dense tool reference: every tool gets exact parameters, defaults, and semantics, and the CLI examples are executable as written. Its main gaps are the absence of validation/confirmation guidance around destructive operations (delete, archive) and no use of reference files to split the CLI and provider-discovery detail.

Suggestions

Add a validation step before destructive commands, e.g. "Before project delete or archive_workspace, confirm the workspaceId/project-id with the user or verify via ls output, since delete archives all active workspaces."

Consider moving the full CLI syntax block and provider-discovery details into a reference file, keeping SKILL.md as the overview.

DimensionReasoningScore

Conciseness

Every sentence carries API facts — parameter requirements, defaults ("Agent-scoped create_agent defaults notifyOnFinish to true"), and semantics ("Bare main prefers local main when it exists, otherwise origin/main") — with zero padding and no explanations of concepts Claude already knows (cron, worktrees, MCP are never defined). Matches anchor 5: lean, assumes competence, every token earns its place.

5 / 5

Actionability

CLI blocks are copy-paste ready ("paseo workspace create --isolation worktree --mode branch-off --new-branch fix-x --base origin/main") and every MCP tool lists exact required and optional parameters plus return shape ("Returns { agentId, workspaceId, … }"). Matches anchor 5: fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The agent-launch flow is well sequenced ("Before choosing how to launch a delegated agent, call this tool and read every profile's notes" with an explicit fallback to provider discovery), but destructive operations — "paseo project delete <project-id>", "archive_workspace", "archive_agent" — are documented with no validation or confirmation step, invoking the destructive-operations cap at 3. Not 4 because checkpoints for the destructive commands are absent rather than a minor gap.

3 / 5

Progressive Disclosure

Clear per-domain sections (Projects, Workspaces, Agents, Schedules, CLI semantics) make the ~135-line body navigable, and product/setup/troubleshooting is properly deferred to the paseo-help skill. Not 5 because all CLI syntax and provider-discovery detail is inline with no reference-file split; not 3 because organization is strong and nothing is buried.

4 / 5

Total

17

/

20

Passed

Description

56%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 accurately scopes the skill's domain by enumerating all six managed entity types, but it relies on a single generic verb ("managing") and provides no use-when trigger guidance. It is distinctive thanks to the Paseo branding yet weak on concrete actions and activation conditions.

Suggestions

Replace the generic "managing" with concrete action verbs, e.g. "Create, list, rename, and delete Paseo projects and workspaces; launch and steer agents; start/stop workspace scripts; create cron schedules and heartbeats via MCP tools or the CLI."

Add an explicit trigger clause such as "Use when the user mentions Paseo, or asks to manage Paseo projects, workspaces, agents, workspace scripts, schedules, or heartbeats."

Mention the control surfaces (MCP tools and the paseo CLI) and "terminals" so users referring to those natural terms match this skill.

DimensionReasoningScore

Specificity

The only action verb is the generic "managing projects, workspaces, workspace scripts, agents, schedules, and heartbeats" — the six nouns enumerate domain objects comprehensively but no concrete actions (create, archive, start/stop) are stated. Matches anchor 2 ("Names the domain but actions are minimal or generic") rather than 3, which requires 1-2 concrete action verbs.

2 / 5

Completeness

The "what" is clear ("Paseo reference for managing projects, workspaces, ... agents, schedules, and heartbeats") but the "when" is entirely absent — there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the when-clause is missing outright, not merely implicit.

3 / 5

Trigger Term Quality

Keywords ("Paseo", "workspaces", "agents", "schedules", "heartbeats", "workspace scripts") are exactly the entity names a user of this product would say. Not 5 because natural terms the body covers — "terminals", "CLI", "MCP" — are absent along with any synonyms; not 3 because coverage spans all major entities rather than only some.

4 / 5

Distinctiveness Conflict Risk

The "Paseo" product name anchors a clear, distinctive niche, so conflict risk is low overall. Not 5 because the generic entity words ("projects", "agents", "schedules") could match other agent-orchestration or scheduling skills when the user does not say "Paseo"; not 3 because the product branding keeps the niche distinct.

4 / 5

Total

13

/

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

phatblat/dotfiles

Path

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