·but-why

Collaboratively write, update, or consult a project's WHY.md and design/ conceptual models — the documents that capture purpose, values, priorities, target users, and how users think about the product. Use when the user wants to create project documentation about why their project exists, discuss project vision or values, write a WHY.md, update conceptual models, revisit project priorities, or when you need to understand a project's purpose and values before doing work. Triggers include "but why", "write a WHY", "document the purpose", "update the why", "project vision", "collaborate on why", "update the design", "conceptual model", "what are the project values", "what's the priority", or "use but-why".

6Installs·1Trend·@h14h

Installation

$npx skills add https://github.com/h14h/doc-skills --skill but-why

How to Install but-why

Quickly install but-why AI skill to your development environment via command line

  1. Open Terminal: Open your terminal or command line tool (Terminal, iTerm, Windows Terminal, etc.)
  2. Run Installation Command: Copy and run this command: npx skills add https://github.com/h14h/doc-skills --skill but-why
  3. Verify Installation: Once installed, the skill will be automatically configured in your AI coding environment and ready to use in Claude Code, Cursor, or OpenClaw

Source: h14h/doc-skills.

SKILL.md

View raw

[!WARNING] Experimental documentation pattern. This skill uses an experimental documentation pattern. Install and use it at your own risk.

Collaboratively create, update, or consult a project's WHY.md and design/ conceptual models.

WHY.md is the philosophical anchor — purpose, values, priorities. design/ contains the conceptual models — how users think about and interact with the product. Both are personal and opinionated, written in the project owner's voice. The agent's role is to elicit, organize, and refine — not to invent.

Collaboratively write, update, or consult a project's WHY.md and design/ conceptual models — the documents that capture purpose, values, priorities, target users, and how users think about the product. Use when the user wants to create project documentation about why their project exists, discuss project vision or values, write a WHY.md, update conceptual models, revisit project priorities, or when you need to understand a project's purpose and values before doing work. Triggers include "but why", "write a WHY", "document the purpose", "update the why", "project vision", "collaborate on why", "update the design", "conceptual model", "what are the project values", "what's the priority", or "use but-why". Source: h14h/doc-skills.

Facts (cite-ready)

Stable fields and commands for AI/search citations.

Install command
npx skills add https://github.com/h14h/doc-skills --skill but-why
Category
#Documents
Verified
First Seen
2026-02-22
Updated
2026-03-10

Browse more skills from h14h/doc-skills

Quick answers

What is but-why?

Collaboratively write, update, or consult a project's WHY.md and design/ conceptual models — the documents that capture purpose, values, priorities, target users, and how users think about the product. Use when the user wants to create project documentation about why their project exists, discuss project vision or values, write a WHY.md, update conceptual models, revisit project priorities, or when you need to understand a project's purpose and values before doing work. Triggers include "but why", "write a WHY", "document the purpose", "update the why", "project vision", "collaborate on why", "update the design", "conceptual model", "what are the project values", "what's the priority", or "use but-why". Source: h14h/doc-skills.

How do I install but-why?

Open your terminal or command line tool (Terminal, iTerm, Windows Terminal, etc.) Copy and run this command: npx skills add https://github.com/h14h/doc-skills --skill but-why Once installed, the skill will be automatically configured in your AI coding environment and ready to use in Claude Code, Cursor, or OpenClaw

Where is the source repository?

https://github.com/h14h/doc-skills

Details

Category
#Documents
Source
skills.sh
First Seen
2026-02-22

Related Skills