intent-capture-discuss

Captures requirements and project analysis through multi-turn dialogue into versioned Markdown documents.

3|1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/ZHLX2005/sl --skill intent-capture-discuss-zhlx2005
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: intent-capture-discuss
Source: https://github.com/ZHLX2005/sl/tree/main/skills/intent-capture-discuss
Command: npx skills add https://github.com/ZHLX2005/sl --skill intent-capture-discuss-zhlx2005

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It turns scattered multi-turn discussions about requirements, project structure, and learning topics into persistent, versioned Markdown documents stored under .claude/repo/_self/, preventing decisions and analysis from being lost in conversation history. ## Core Features & Use Cases - Three discussion modes: Intent mode (requirements and design drafts), project-learning mode (status, concepts, comparisons), and basic-knowledge mode (concept notes), each producing only its allowed document types. - Versioned document system: Intent, design, status, compare, and concepts documents follow strict naming conventions with auto-incrementing versions; old versions are never overwritten. - Reference repository analysis: Reads external repos under .claude/repo/ and writes source-evidence-backed analysis documents into _self/_read/ with mandatory file path and line number citations. - Use Case: A user discussing how to design an auth module gets a structured intent document plus iterated design drafts (v1, v2...) with verbatim original requests, while a separate discussion analyzing the current codebase produces a status document and a comparison against open-source implementations. ## Quick Start Ask the assistant to help you organize your requirements or analyze a project module, for example by saying you want to clarify the goal and design of a new feature and have the discussion saved as structured documents.

Frequently Asked Questions about intent-capture-discuss

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a requirements discussion into structured documentation?

Start a discussion about your requirement and the skill runs in intent mode, producing an intent document plus versioned design drafts under .claude/repo/_self/{topic}/intent/. Each design iteration creates a new versioned file while old versions are preserved read-only.

How to compare my project implementation against open-source references?

Ask to compare with reference projects and the skill reads repositories under .claude/repo/, then generates a compare document in the project/ folder. The comparison covers external implementation methods versus your project's current degree of implementation across agreed dimensions.

Does this skill modify my source code during analysis?

No, the skill is strictly documentation-only and forbidden from creating, editing, or deleting any source code files. Its only outputs are Markdown files inside .claude/repo/_self/, and it never runs git commits, builds, or tests.

What is the difference between intent mode and project learning mode?

Intent mode captures why and how you plan to build something, producing intent and design documents. Project learning mode only documents current reality, producing status, concepts, and compare documents under project/ without generating any intent or design files.

Why must documents include the original user request verbatim?

Design and status documents must quote the user's original words verbatim plus a lightly corrected version to prevent requirement drift. This ensures every analysis conclusion and design decision can be traced back to what the user actually asked rather than an AI paraphrase.