CtrlK
BlogDocsLog inGet started
Tessl Logo

talk-moss-skills-team-workflow

Explains James Moss's team-skills workflow and helps design skill governance: decomposition, ownership, versioning, eval scenarios, quality review, and lifecycle maintenance. Use when the user asks about moving from solo skill hacks to team workflow, avoiding skill sprawl, or treating skills like software.

64

Quality

78%

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 ./Plugins/aidevcon/skills/talk-moss-skills-team-workflow/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.

A well-organized reference skill body that stays lean and sequences its workflows clearly. It is weaker on actionability, where several governance directives stay high-level, and its referenced detail files are not bundled for verification.

Suggestions

Concretize abstract governance steps — e.g., show an owner/version table format and a sample decomposition plan instead of only naming the action.

Ensure referenced files (outline.md, quote.md, transcript.md) actually ship in the bundle so the Read Order navigation resolves.

Add one fully worked example (decomposition plan + owner table + eval list) to lift actionability from high-level to copy-paste ready.

DimensionReasoningScore

Conciseness

Lean body that assumes Claude's competence and avoids explaining known concepts; minor redundancy between the Core Workflow and Examples sections could be tightened.

4 / 5

Actionability

Provides numbered steps, output templates, and example response shapes, but several directives are abstract ('Prefer extension by composition over editing shared instructions blindly', 'Assign owner and version policy') without concrete how-to detail.

3 / 5

Workflow Clarity

Distinct workflows for factual questions and applying the talk are clearly sequenced with numbered steps and coverage/redaction checkpoints; no destructive/batch validation is needed, so minor checkpoint gaps are acceptable.

4 / 5

Progressive Disclosure

A clear Read Order points one level deep to outline.md, quote.md, and transcript.md with well-signaled navigation, but the referenced bundle files are not present in the bundle directory to verify.

4 / 5

Total

15

/

20

Passed

Description

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

A strong, third-person description that states concrete capabilities and provides an explicit 'Use when' trigger clause with natural phrasing. Minor room to add synonyms for trigger terms.

DimensionReasoningScore

Specificity

Lists multiple concrete governance capabilities — 'decomposition, ownership, versioning, eval scenarios, quality review, and lifecycle maintenance' — giving comprehensive coverage of the skill's actions.

5 / 5

Completeness

Explicitly answers both 'what' (explains the workflow and helps design governance) and 'when' ('Use when the user asks about moving from solo skill hacks to team workflow, avoiding skill sprawl, or treating skills like software') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — 'skill sprawl', 'treating skills like software', 'team workflow', 'solo skill hacks' — with good coverage, though a few common synonyms are absent.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (team skill governance) with specific triggers, but broad terms like 'team workflow' carry minor overlap risk with adjacent skills.

4 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
jscraik/Agent-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.