CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

shape-up

Use when asked to "shape up", "run a shaping session", "set an appetite", "scope a project without estimates", "betting table", or "ship in fixed cycles". Helps teams escape estimate-driven development and Scrum fatigue. The Shape Up method (created by Ryan Singer at Basecamp/37signals) uses fixed time boxes, variable scope, and collaborative shaping to ship meaningful work predictably.

Quality

60%

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

Quality

Content

26%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 reads as a marketing-flavored overview of the Shape Up philosophy rather than an operational skill: it explains concepts Claude already knows and provides no workflow, templates, or concrete procedure for actually running a shaping session. Structure is acceptable for a single short file, but token budget and actionability are the clear weaknesses.

Suggestions

Add a concrete, sequenced shaping workflow (e.g., 1. Clarify the problem and constraints, 2. Set the appetite (6 or 2 weeks), 3. Sketch at fat-marker fidelity, 4. De-risk technical unknowns, 5. Write the pitch using a standard template, 6. Present at the betting table) with explicit checkpoints.

Include a copy-paste-ready pitch template (Problem, Appetite, Solution, Rabbit holes, No-gos) so the skill produces concrete artifacts instead of philosophy.

Cut the padding: remove the "Domain Context" boilerplate, the generic "Input Requirements" section, and the Basecamp/DHH history anecdote, and merge the duplicate "Resources"/"Further Reading" sections into one.

DimensionReasoningScore

Conciseness

The body re-explains Shape Up, a methodology Claude already knows: "Shape Up is a product development methodology built on one core insight...", plus the 17-years-of-Basecamp/DHH history anecdote. The "Domain Context" section ("This skill implements a proven product management framework. The approach combines best practices from industry leaders...") and the generic "Input Requirements" boilerplate are pure padding, matching 'Noticeably verbose; several unnecessary explanations or padded sections'. It is not 3 because the padding spans multiple sections rather than isolated sentences.

2 / 5

Actionability

The content is instruction-free philosophy: there is no pitch template, no appetite-setting procedure, no steps for running a shaping session or betting table — only descriptive framing plus when-to-use checklists. As an instruction-only skill its lack of code is not penalized, but the guidance stays at the 'high-level hints' level ('Move from "What's the estimate for this?" to "What version of this can we confidently ship..."'), missing the specific steps to execute, matching the 2 anchor rather than 3.

2 / 5

Workflow Clarity

No multi-step process is presented anywhere: the body never sequences a shaping workflow (set appetite → sketch → de-risk → write pitch → bet) and has no checkpoints or validation steps. This matches the 1 anchor ('Steps missing or incoherent; no sequence'); it cannot be 2 because even a rough step sequence is absent — the sections are conceptual, not procedural.

1 / 5

Progressive Disclosure

The skill is a single short file with no bundle directories and no nested references, and sections are headers-based and scannable, which fits 'Good structure; most content is appropriately placed'. It misses 5 because of minor organization gaps: template-boilerplate sections ("Domain Context", "Input Requirements") stacked above the real content, two heading hierarchies (`## Domain Context` before `# Shape Up`), and redundant split "Resources"/"Further Reading" sections.

4 / 5

Total

9

/

20

Passed

Description

73%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, distinctive description with an explicit and natural trigger list that clearly separates it from neighboring agile/PM skills. The main weakness is that the 'what' is expressed as methodology properties (time boxes, variable scope) rather than the concrete actions the skill performs, leaving capability coverage incomplete.

DimensionReasoningScore

Specificity

The description names the domain clearly ("fixed time boxes, variable scope, and collaborative shaping") and gives one concrete purpose ("Helps teams escape estimate-driven development and Scrum fatigue"), but it describes the method's properties rather than listing the concrete actions the skill performs. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — not 4, because there is no enumeration of specific capabilities, and not 2, because the domain and mechanics are concretely characterized.

3 / 5

Completeness

Both parts are present: an explicit "Use when asked to..." clause with concrete triggers, and a what-statement ("uses fixed time boxes, variable scope, and collaborative shaping to ship meaningful work predictably"). The 'when' is fully explicit, but the 'what' describes the methodology at a conceptual level rather than what the skill concretely does, so it does not reach the clarity of the 5 anchor.

4 / 5

Trigger Term Quality

Trigger phrases like "run a shaping session", "set an appetite", "betting table", and "scope a project without estimates" are natural things a user would say, with good synonym coverage. It falls short of the 5 anchor because common variations such as "pitch", "six-week cycle", or "shaped work" are missing; it is clearly above 3 since multiple distinct natural phrasings are present.

4 / 5

Distinctiveness Conflict Risk

Triggers like "betting table" and "set an appetite" are highly specific to the Shape Up niche and would not plausibly fire a different skill. It matches the 5 anchor ('Clear niche with distinct triggers; minimal conflict risk'); only "ship in fixed cycles" has slight overlap with generic agile skills, which is not enough to drop to 4.

5 / 5

Total

16

/

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

saski/arnesto

Path

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