Skip to content
Back to search

shaping-skills

SkillWorks with Claude CodeGitHub

Skills I use with Claude for shaping

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rjs--shaping-skills/badge.svg)](/listings/rjs--shaping-skills)

HTML

<a href="/listings/rjs--shaping-skills"><img src="/api/listings/rjs--shaping-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Clone the repo, then symlink each skill into your Claude Code skills directory
git clone https://github.com/rjs/shaping-skills.git ~/.local/share/shaping-skills
ln -s ~/.local/share/shaping-skills/framing-doc ~/.claude/skills/framing-doc
ln -s ~/.local/share/shaping-skills/kickoff-doc ~/.claude/skills/kickoff-doc
ln -s ~/.local/share/shaping-skills/breadboarding ~/.claude/skills/breadboarding
ln -s ~/.local/share/shaping-skills/shaping ~/.claude/skills/shaping

Each skill must be a direct child of `~/.claude/skills/` so Claude Code can discover it. Symlinks keep them updatable with `git pull`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 80 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Shaping Skills
  2. NOTE: THESE ARE OBSOLETE! I experimented with these skills back when Opus 4.6 was a frontier model. I haven't used this skills since then.
  3. [Claude Code](https://claude.com/claude-code) skills for shaping and breadboarding — the methodology from [Shape Up](https://basecamp.com/shapeup) adapted for working with an LLM.
  4. **Case study:** [Shaping 0-1 with Claude Code](https://x.com/rjs/status/2020184079350563263) walks through the full process of building a project from scratch using these skills. The source for that project is at [rjs/tick](https://github.com/rjs/tick).
  5. ## Skills
  6. ### Document skills — for collaborative work
  7. These turn transcripts of real conversations into structured shaping documents. They're useful on real production projects where you're working with other people and want to capture what was said in a format you can act on.
  8. **These are extremely GIGO (garbage in, garbage out).** They don't evaluate whether the material makes sense or is reasonable. They format and distill — that's it. When your inputs are good conversations with good thinking, they save a ton of time. When your inputs are bad, you get a nicely formatted bad document.
  9. **`/framing-doc`** — Turn conversation transcripts into a framing document that captures the problem worth solving and why it was chosen over alternatives.
  10. **`/kickoff-doc`** — Turn a shaped project kickoff transcript into a reference document for the builder, capturing what was shaped and agreed.
  11. ### Solo skills — more experimental
  12. These are for working with Claude directly on shaping and design. They're more experimental and less battle-tested than the document skills.
  13. **`/shaping`** — Iterate on both the problem (requirements) and solution (shapes) before committing to implementation. Separates what you need from how you might build it, with fit checks to see what's solved and what isn't.
  14. **`/breadboarding`** — Map a system into UI affordances, code affordances, and wiring. Shows what users can do and how it works underneath — in one view. Good for slicing into vertical scopes.
  15. ## Install
  16. ```bash
  17. # Clone the repo, then symlink each skill into your Claude Code skills directory
  18. git clone https://github.com/rjs/shaping-skills.git ~/.local/share/shaping-skills
  19. ln -s ~/.local/share/shaping-skills/framing-doc ~/.claude/skills/framing-doc
  20. ln -s ~/.local/share/shaping-skills/kickoff-doc ~/.claude/skills/kickoff-doc
  21. ln -s ~/.local/share/shaping-skills/breadboarding ~/.claude/skills/breadboarding
  22. ln -s ~/.local/share/shaping-skills/shaping ~/.claude/skills/shaping
  23. ```
  24. Each skill must be a direct child of `~/.claude/skills/` so Claude Code can discover it. Symlinks keep them updatable with `git pull`.
  25. ## Hook: Ripple Check
  26. The repo includes a hook that reminds Claude to check for ripple effects when editing shaping documents. When Claude writes or edits a `.md` file with `shaping: true` in its frontmatter, the hook prompts a checklist — update affordance tables, fit checks, work streams, etc.
  27. ### Setup
  28. 1. Symlink the hook script:
  29. ```bash
  30. mkdir -p ~/.claude/hooks
  31. ln -s ~/.local/share/shaping-skills/hooks/shaping-ripple.sh ~/.claude/hooks/shaping-ripple.sh
  32. ```
  33. 2. Add the hook to your `~/.claude/settings.json`:
  34. ```json
  35. {
  36. "hooks": {
  37. "PostToolUse": [
  38. {
  39. "matcher": "Write|Edit",
  40. "hooks": [
  41. {
  42. "type": "command",
  43. "command": "~/.claude/hooks/shaping-ripple.sh",
  44. "timeout": 5
  45. }
  46. ]
  47. }
  48. ]
  49. }
  50. }
  51. ```
  52. This fires after every `Write` or `Edit` tool call. It only activates for shaping documents (those with `shaping: true` frontmatter) — all other files pass through silently.
  53. ---
  54. This README was written by [Claude Code](https://claude.com/claude-code).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.