agentleFS
Sign inStart free
maragudkmaragudk/skills/design-doc/SKILL.md

design-doc

Skill49 starsChanged 9 months agoMITView on GitHub

For when you're asked to write a design doc or specification, especially after a brainstorm or feature design session.

We split this skill into the rules it gives an agent

1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 19 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Don't include too many code examples, unless necessary because they contain valuable details uncovered during the brainstorm or design …

    line 17

“Common” is measured: kept by at least 6 in 10 of the 19 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
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.

Download now (ZIP)

  • Other versions23 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 23

    1. na0fu3y/ochakai★ 21same name
    2. akash-joshi/agent-skills★ 8same name
    3. e2bgateway/e2bgateway★ 7same name
    4. taniwhaai/arai★ 7same name
    5. kelesmert/turnlens★ 4same name
    6. arsudsandesh97/Revoact★ 3same name
    7. dfrysinger/skills★ 2same name
    8. Rahlir/clanker-stuff★ 2same name
    9. alabenkhlifa/dayjob★ 1same name
    10. f-ewald/claude-skills★ 1same name

    13 more not listed

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use adr, adversarial-review and 2 more.

    Other files people use alongside this one.

    Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
    • asterkinSkill

      adr

      Create Architecture Decision Records (ADRs) following project standards. Guides template usage, process, and best practices for documenting architecturally significant decisions.

      Also in 3 projects that use this

    • MicrosoftSkill

      adversarial-review

      Adversarial review of a system design from 6 critical perspectives -- SRE, security, staff engineer, finance, operator, and developer advocate. Produces a unified risk assessment. Use for INTERACTIVE on-demand reviews during a design conversation (/adversarial-review). For RECIPE-DRIVEN reviews (where prior step context is needed), use the systems-design-critic agent instead.

      Also in 3 projects that use this

    • GoogleSkill

      grill-me

      A relentless interview to sharpen a plan or design.

      Also in 4 projects that use this

    • SentrySkill

      commit

      Create commit messages following Sentry conventions. Use when committing code changes, writing commit messages, or formatting git history. Follows conventional commits with Sentry-specific issue references.

      Also in 3 projects that use this

  • In this repository20 other files it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free