CtrlK
BlogDocsLog inGet started
Tessl Logo

personal-squad

User-level AI agents that travel with you across projects

51

Quality

56%

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

Fix and improve this skill with Tessl

tessl review fix ./.squad/skills/personal-squad/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 a well-organized, actionable reference for personal-squad configuration with concrete commands and clear sequencing, weakened only by a dangling reference to a missing templates file.

Suggestions

Either add templates/ghost-protocol.md to the bundle or inline the Ghost Protocol rules so the referenced content is actually available.

Show one short example output for `squad personal add` and `squad cast` so the commands are fully copy-paste verifiable.

Trim the "What is a Personal Squad?" prose to a one-line definition to further tighten token use.

DimensionReasoningScore

Conciseness

The body is efficient with sectioned CLI commands, env vars, and a config snippet, though a few explanatory lines ("What is a Personal Squad?", ambient-discovery prose) could be trimmed.

4 / 5

Actionability

Concrete executable commands are listed (squad personal init/add/remove, SQUAD_NO_PERSONAL=1) with a real config.json example; minor gaps such as missing sample output keep it just below fully copy-paste complete.

4 / 5

Workflow Clarity

"How It Works" provides a clear four-step sequence with a kill switch and no destructive/batch operations requiring validation, fitting the clear-sequence-with-minor-checkpoint-gaps anchor.

4 / 5

Progressive Disclosure

Sections are organized, but the body references templates/ghost-protocol.md which does not exist in the bundle, leaving a navigation reference unresolvable and fitting the some-structure/incomplete-reference anchor.

3 / 5

Total

15

/

20

Passed

Description

41%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 clearly conveys the niche (user-level agents persisting across projects) but lacks concrete actions and any explicit trigger guidance, leaving users without a natural "when to use this" signal.

Suggestions

Add concrete actions, e.g. "Bootstrap, list, add, and remove personal AI agents that persist across projects".

Append a trigger clause such as "Use when managing user-level squad agents or configuring cross-project agent behavior".

Include natural user-facing terms ("personal agents", "global squad config") and the SQUAD_NO_PERSONAL kill switch as a discoverable keyword.

DimensionReasoningScore

Specificity

The description names the domain ("User-level AI agents that travel with you across projects") but lists no concrete actions; it describes what the thing is rather than what it does, matching the anchor that names a domain with minimal/generic actions.

2 / 5

Completeness

A clear "what" is present (user-level agents traveling across projects) but no "when" trigger guidance, so per the guideline it caps at 3 rather than reaching 4.

3 / 5

Trigger Term Quality

It offers only one or two generic/jargon terms ("AI agents", "across projects") and omits the natural phrases a user would actually say; there is no "Use when..." trigger language.

2 / 5

Distinctiveness Conflict Risk

The personal/user-level-agent niche is mostly distinct with only minor overlap risk against project-level agent skills, fitting the anchor for a mostly-distinct skill.

4 / 5

Total

11

/

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
bradygaster/squad
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.