All skills
jwynia avatar

/system-design

@6ac6c30
by J Wyniajwynia/agent-skills160 stars
20

Diagnose design problems and guide architecture decisions for solo developers

Use this Skill: https://skilld.dev/gh/jwynia/agent-skills/system-design

This session only. Nothing lands on disk.

assetsdesign-context.md

≈403 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Design Context: [Project Name]

Requirements Summary

[From requirements-analysis, summarize in 2-3 sentences]

Problem: [One sentence] Core needs: [Bullet list of must-haves] Key constraints: [From constraint inventory]

Quality Attributes (Prioritized)

Rank these by importance for THIS project. Not all matter equally.

  1. [Attribute] - [Why it matters for this project]
  2. [Attribute] - [Why it matters]
  3. [Attribute] - [Why it matters]

Common attributes to consider:

  • Simplicity (can you understand it in 6 months?)
  • Performance (does speed actually matter here?)
  • Maintainability (will you change this often?)
  • Reliability (what's the cost of failure?)
  • Extensibility (will you actually extend it?)

Real Constraints

From constraint inventory - things that limit design options.

Constraint Design Impact
[constraint] [what this rules out or requires]
[constraint] [design impact]

Design Goals

What the architecture should optimize for (derived from quality attributes):

  • [Goal 1]
  • [Goal 2]
  • [Goal 3]

Explicitly Not Optimizing For

Trade-offs we're accepting. What we're giving up.

  • [Thing we're NOT optimizing] - [why it's okay to deprioritize]
  • [Thing we're NOT optimizing] - [why acceptable]

Validation

Before proceeding to architecture decisions:

  • Requirements summary matches validated requirements
  • Quality attributes are ranked (not all equal)
  • Constraints are design-relevant (not implementation details)
  • At least one thing is explicitly NOT being optimized for

Source: SKILL.md on GitHub

1 warning15d5 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    The analyzed skill is a technical guide for system design, helping developers document architectural decisions through templates for ADRs and component maps. It contains no executable code or dangerous instructions.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: LOW · No issues

  • Runlayer7mo

    5/5 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 6ac6c30. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 8 months ago
Other metadata
metadata
{
  "author": "jwynia",
  "version": "1.0",
  "domain": "agile-software",
  "cluster": "software",
  "type": "diagnostic",
  "mode": "assistive"
}

README badge

README badge for jwynia/agent-skills/system-design