Agent skill
design-doc
For when you're asked to write a design doc or specification, especially after a brainstorm or feature design session.
Install this agent skill to your Project
npx add-skill https://github.com/maragudk/skills/tree/main/design-doc
SKILL.md
Design Doc
This skill is for when you're asked to write a design document or design specification, especially after a brainstorm or feature design session.
Design docs go into the docs/ directory in the project root. Create the folder if it doesn't exist.
The design doc is in Markdown. Choose a concise, relevant name yourself.
Content
- Be concise.
- Don't include too many code examples, unless necessary because they contain valuable details uncovered during the brainstorm or design session.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
bluesky
Guide for posting content to the Bluesky social network using the bsky terminal app. This skill should be used proactively when working in public repositories and there is interesting, shareable content (new features, insights, achievements, or announcements worth sharing with the community). Use it when asked to post to Bluesky, or when content seems worth sharing publicly.
observable-plot
datastar
Guide for building interactive web UIs with Datastar and gomponents-datastar. Use this skill when adding frontend interactivity to Go web applications with Datastar attributes.
go
Guide for how to develop Go apps and modules/libraries. Always use this skill when reading or writing Go code.
worktrees
Guide for using git worktrees to parallelize development with coding agents. Use this skill when the user requests to work in a new worktree or wants to work on a separate feature in isolation (e.g., "Work in a new worktree", "Create a worktree for feature X").
collaboration
Guide for collaborating on GitHub projects. This skill should be used when contributing to projects, creating PRs, reviewing code, or managing issues on GitHub.
Didn't find tool you were looking for?