rjs/shaping-skills

rjs 资料

最近记录的来源活动: 2026年4月10日 10:11

SkillsMP 收录数据更新: 2026年10月26日 11:37

已收集 skills: 4

GitHub 星标: 1,446
GitHub Forks: 96

仓库 README

仓库 README 来源：README.md

查看 README 源文件

展开完整 README

# Shaping Skills 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. [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. **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). ## Skills ### Document skills — for collaborative work 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. **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. **`/framing-doc`** — Turn conversation transcripts into a framing document that captures the problem worth solving and why it was chosen over alternatives. **`/kickoff-doc`** — Turn a shaped project kickoff transcript into a reference document for the builder, capturing what was shaped and agreed. ### Solo skills — more experimental These are for working with Claude directly on shaping and design. They're more experimental and less battle-tested than the document skills. **`/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. **`/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. ## Install ```bash # 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`. ## Hook: Ripple Check 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. ### Setup 1. Symlink the hook script: ```bash mkdir -p ~/.claude/hooks ln -s ~/.local/share/shaping-skills/hooks/shaping-ripple.sh ~/.claude/hooks/shaping-ripple.sh ``` 2. Add the hook to your `~/.claude/settings.json`: ```json { "hooks": { "PostToolUse": [ { "matcher": "Write|Edit", "hooks": [ { "type": "command", "command": "~/.claude/hooks/shaping-ripple.sh", "timeout": 5 } ] } ] } } ``` 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. --- This README was written by [Claude Code](https://claude.com/claude-code).

正在加载仓库 README…

这个仓库中的 skills

项目管理专家软件开发工程师

2 个职业分类 · 已分类 100%

skill

职业分类

描述

更新

kickoff-doc

项目管理专家

Turn a shaped project kickoff transcript into a reference document for the builder. Use when the user has a transcript (VTT, etc.) from a kickoff call and wants to produce a document that captures what was shaped and agreed.

原文语言：英语

2026-04-10

framing-doc

项目管理专家

Create a framing document from conversation transcripts. Use when the user has transcripts (VTT, call notes, etc.) and wants to produce a frame that captures the problem worth solving and why it was chosen over alternatives.

原文语言：英语

2026-03-04

shaping

项目管理专家

Use this methodology when collaboratively shaping a solution with the user - iterating on problem definition (requirements) and solution options (shapes).

原文语言：英语

2026-02-11

breadboarding

软件开发工程师

Transform a workflow description into affordance tables showing UI and Code affordances with their wiring. Use to map existing systems or design new ones from shaped parts.

原文语言：英语

2026-02-11

已展示 4 / 4 个已收集 Skill。

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 AI 助手。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/rjs/shaping-skills.