Skills agile-design-doc
📦

agile-design-doc

Content revision r2 Safe ⚙️ External commands

Create Focused Agile Design Documents

Feature teams often lose time in lengthy or incomplete technical planning. This skill creates concise, repository-aware design documents focused on MVP delivery.

Supports: Claude Codex Code(CC)
📊 75 Adequate

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request
Review the Skillstore skill "agile-design-doc" from https://skillstore.io/skills/ariesyb-agile-design-doc.md and its manifest at https://skillstore.io/api/skills/ariesyb-agile-design-doc/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Your Agent should still show its plan and request any confirmation required by the security policy.

Agent-readable resources

Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.

Markdown detail GET /skills/ariesyb-agile-design-doc.md Signed manifest GET /api/skills/ariesyb-agile-design-doc/manifest Signed lockfile GET /api/skills/ariesyb-agile-design-doc/lockfile

Test it

Using "agile-design-doc". Design passwordless sign-in for an existing web application using its current session service.

Expected outcome:

A concise design covering sign-in goals, email-link flow, session-service reuse, token handling, endpoint changes, and deferred enhancements.

Using "agile-design-doc". Plan an order-status notification module for a service that already uses a message queue.

Expected outcome:

  • MVP scope for status-change notifications
  • Mermaid sequence for order, queue, worker, and provider interactions
  • Implementation notes for existing queue components
  • Required event and API changes

Using "agile-design-doc". Add team invitations to an existing SaaS application with a two-week delivery limit.

Expected outcome:

A repository-aligned design that defines invitation scope, user flow, data changes, endpoints, implementation methods, assumptions, and later improvements.

Security Audit

Safe
v5 • 7/23/2026 Open versioned report

All 28 static findings are false positives caused by Markdown code fences, Mermaid diagrams, or UTF-8 Chinese documentation. No executable shell commands, obfuscated payloads, prompt injection, or malicious intent were found.

2
Files scanned
315
Lines analyzed
0
Review items
0
False positives ignored

Risk Factors

⚙️ External commands (25)
SKILL.md:39-42 SKILL.md:42-45 SKILL.md:45-58 SKILL.md:58-61 SKILL.md:61-72 SKILL.md:72-79 SKILL.md:79-83 SKILL.md:83-86 SKILL.md:86-93 SKILL.md:93-96 SKILL.md:96-98 SKILL.md:98-111 SKILL.md:111-117 SKILL.md:117-131 SKILL.md:131-139 SKILL.md:139-147 SKILL.md:147-153 SKILL.md:153-156 SKILL.md:156-163 SKILL.md:163-193 SKILL.md:193-199 SKILL.md:199-202 SKILL.md:202-208 SKILL.md:208-211 SKILL.md:211-217
No confirmed security findings were detected by the latest completed static and semantic audit. This does not prove the skill has no side effects.
Audited by: codex View Audit History →
Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report
Security Assessment

Copy report link

https://skillstore.io/skills/ariesyb-agile-design-doc/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/ariesyb-agile-design-doc/security.svg)](https://skillstore.io/skills/ariesyb-agile-design-doc?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/ariesyb-agile-design-doc?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/ariesyb-agile-design-doc/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/ariesyb-agile-design-doc.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Academic citations (APA · BibTeX · CFF)

APA citation

AriesYB. (2026). agile-design-doc security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/ariesyb-agile-design-doc/audits/5

BibTeX citation

@techreport{ariesyb-ariesyb-agile-design-doc-2026, author = {AriesYB}, title = {agile-design-doc security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/ariesyb-agile-design-doc/audits/5}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "agile-design-doc security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "AriesYB" date-released: "2026-07-23" url: "https://skillstore.io/skills/ariesyb-agile-design-doc/audits/5" identifiers: - type: other value: "skillstore:ariesyb-agile-design-doc:audit:5" description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: High
41
Architecture
85
Maintainability
87
Content
68
Community
91
Spec Compliance

What You Can Build

Plan a New Product Feature

Convert feature requirements into goals, interactions, implementation steps, models, and interfaces that support an MVP release.

Align an Agile Delivery Team

Create a compact design reference that gives developers and product staff a shared technical scope.

Extend an Existing Service

Review the current stack and components before designing a compatible module that reuses established project patterns.

Try These Prompts

Draft a Basic Design 
Create an MVP-focused design document for [feature]. Include goals, a short feature list, and the main interaction flow.
Design from Repository Context 
Review this repository and design [feature]. Identify the technology stack and reusable components before proposing implementation details.
Define Service Changes 
Design [feature] for this service. Include Mermaid interactions, changed data models, API definitions, key methods, and technical challenges.
Evaluate Scope and Tradeoffs 
Create a focused design for [feature] under [constraints]. Separate MVP scope from later work and explain reuse, tradeoffs, risks, and assumptions.

Best Practices

  • Provide the feature goal, delivery constraints, and relevant repository context.
  • Confirm which existing components and conventions the design should reuse.
  • Review assumptions and deferred items with engineering and product stakeholders.

Avoid

  • Do not request a stack-specific design without repository access or technology details.
  • Do not treat illustrative methods as tested production code.
  • Do not expand optional features into the MVP without an explicit delivery need.

Frequently Asked Questions

What information should I provide?
Provide the feature goal, current system context, constraints, and repository access when available.
Does the skill inspect an existing project?
Yes. It reviews configuration, source structure, documentation, and reusable components when those files are available.
What sections can the design include?
It can include goals, features, interactions, implementation details, key methods, technical challenges, models, and interfaces.
Does it generate production code?
No. It provides illustrative code for key methods, but implementation and testing remain separate tasks.
How does it prevent excessive scope?
It prioritizes core functionality, marks optional work for later iterations, and checks for unnecessary sections or features.
Can it work when requirements are incomplete?
Yes. It reviews available project context, asks focused questions, and records reasonable assumptions in the document.

Developer Details

Author

AriesYB

License

MIT

Skillstore revision

r2

Version notice

The author did not declare a version.

Repository

https://github.com/AriesYB/agile-design-doc-skill/tree/main/skill

Ref

89edfdc710d0846129dcee6a929477b04f08052c

Maintenance freshness

7/24/2026

Usage

12 downloads · 88 views

File structure

📁 references/

📄 template.md

📄 SKILL.md