guicaulada/design-doc
home/dot_claude/exact_skills/design-doc/SKILL.md
Creates design documents using Prompt-Driven Development to refine ideas into structured proposals. Use when user mentions design doc, design document, RFC, technical proposal, architecture proposal, write a proposal, or PDD. Do not use for implementation plans, code reviews, bug fixes, or task tracking.
$ install --global
skillsauthnpx skillsauth add guicaulada/dotfiles design-docInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 7, 2026, 7:30 AM179.8s2 files scanned
SKILL.md
- name:
- design-doc
- description:
- Creates design documents using Prompt-Driven Development to refine ideas into structured proposals. Use when user mentions design doc, design document, RFC, technical proposal, architecture proposal, write a proposal, or PDD. Do not use for implementation plans, code reviews, bug fixes, or task tracking.
- allowed-tools:
- Read, Write, Bash(mkdir *), Glob, Grep, WebSearch
- argument-hint:
- [topic or rough idea]
Design Doc
Create structured design documents using Prompt-Driven Development (PDD). Guides users through iterative refinement of rough ideas into comprehensive design documents with multiple proposals, trade-off analysis, and consensus tracking.
Document Structure
| Section | Purpose | |------------|-----------------------------------------| | Background | Sets context in 1-2 paragraphs | | Problem | Explains why action is needed now | | Goals | Defines success criteria and priorities | | Proposals | At least 2-3 options with trade-offs | | Do Nothing | Always included as Proposal 0 baseline | | Consensus | Documents decision and participants |
PDD Methodology
The skill follows the Prompt-Driven Development methodology — iterative refinement through requirements clarification, research, and checkpoint reviews before generating the design document. The full process is embedded in the create workflow.
Workflows
Create Design Document
Trigger: "design doc", "design document", "RFC", "technical proposal", "architecture proposal", "write a proposal", "PDD"
Should NOT trigger: "implement the feature", "review this PR", "fix this bug", "create a task list", "write tests"
Read and follow create.md.
Related Skills
guicaulada/triage
testing
VerifiedTrustedCommunity
Fetches GitHub issues, pull requests, reviews, notifications, and project board data for the user and optionally teammates, then analyzes their state and produces a prioritized work plan. Use when prioritizing work, triaging GitHub activity, planning what to work on next, assessing current workload, checking sprint status, or reviewing project board items. Supports teammate usernames and focus areas via arguments. Do NOT use for creating, modifying, or closing issues, PRs, or other GitHub resources.
1SKILL.mdUpdated May 7, 2026
guicaulada/summarize
testing
VerifiedTrustedCommunity
Transforms text into exhaustive structured bullet-point summaries for studying and test preparation. Use when user mentions summarize, create a summary, bullet point this, give me the key points, study notes, help me study, prepare for exam, create study guide, or make flashcard content.
1SKILL.mdUpdated May 7, 2026
guicaulada/review-pr
development
VerifiedTrustedCommunity
Reviews pull requests with detailed code analysis and feedback. Use when user mentions review pr, pr review, review pull request, check pr, analyze pr, code review, review prs, batch review. Not for dependency bump PRs (use /review-deps instead).
1SKILL.mdUpdated May 7, 2026
guicaulada/review-deps
testing
VerifiedTrustedCommunity
Reviews dependency bump PRs with focus on compatibility and security issues. Use when user mentions review deps, review dependencies, dependency review, check deps, dependency prs, dep bumps, review deps prs, batch dep review.
1SKILL.mdUpdated May 7, 2026