architecture-documenter
Document Software Architecture Clearly
Teams often lose context for system design and technical decisions. This skill creates structured architecture documents, ADRs, diagrams, and review guidance.
Install with my Agent
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Review the Skillstore skill "architecture-documenter" from https://skillstore.io/skills/curiouslearner-architecture-documenter.md and its manifest at https://skillstore.io/api/skills/curiouslearner-architecture-documenter/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.
Test it
Using "architecture-documenter". Document a payments service that uses a web app, API gateway, payment provider, database, and webhook processor.
Expected outcome:
A structured architecture document with system context, component responsibilities, webhook flow, payment security notes, failure handling, and recommended diagrams.
Using "architecture-documenter". Write an ADR for moving from server sessions to JWT authentication.
Expected outcome:
An ADR with accepted status, context, decision, alternatives, consequences, token security concerns, rollout plan, and rollback guidance.
Using "architecture-documenter". Update architecture docs before a microservices migration review.
Expected outcome:
A review-ready outline covering current dependencies, target service boundaries, data ownership, deployment changes, observability, risks, and decision gaps.
Security Audit
SafeThe static findings are all false positives after contextual review of SKILL.md. They come from Markdown code fences, documentation examples, reference URLs, private CIDR examples, and illustrative JWT snippets rather than executable skill behavior.
Risk Factors
⚙️ External commands (65)
🌐 Network access (6)
🔑 Env variables (6)
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.
Copy report link
https://skillstore.io/skills/curiouslearner-architecture-documenter/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown badge
[](https://skillstore.io/skills/curiouslearner-architecture-documenter?utm_source=security_passport_badge)HTML badge
<a href="https://skillstore.io/skills/curiouslearner-architecture-documenter?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/curiouslearner-architecture-documenter/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Embed card
<iframe src="https://skillstore.io/embed/skills/curiouslearner-architecture-documenter.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
CuriousLearner. (2026). architecture-documenter security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/curiouslearner-architecture-documenter/audits/9BibTeX citation
@techreport{curiouslearner-curiouslearner-architecture-documenter-2026,
author = {CuriousLearner},
title = {architecture-documenter security audit report (audit version 9)},
institution = {Skillstore},
year = {2026},
number = {9},
url = {https://skillstore.io/skills/curiouslearner-architecture-documenter/audits/9},
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: "architecture-documenter security audit report (audit version 9)"
version: "unspecified"
type: report
authors:
- name: "CuriousLearner"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/curiouslearner-architecture-documenter/audits/9"
identifiers:
- type: other
value: "skillstore:curiouslearner-architecture-documenter:audit:9"
description: "Skillstore immutable audit report identifier"
Skillstore Score
Why this score Evidence Confidence: HighWhat You Can Build
Create a System Architecture Document
Turn system context, services, data stores, integrations, and deployment notes into a clear architecture reference.
Record Technical Decisions
Capture why a technology, pattern, or migration path was chosen, including alternatives and trade-offs.
Prepare Onboarding Documentation
Summarize system boundaries, workflows, diagrams, and operational concerns for new team members.
Try These Prompts
Create a system architecture overview for this project. Include purpose, users, main components, data stores, integrations, and open questions.
Document the architecture for these components and data flows. Include responsibilities, dependencies, failure modes, diagrams to create, and assumptions.
Write an ADR for this decision. Include context, decision, alternatives considered, consequences, risks, mitigation, rollout plan, and review date.
Create an architecture review pack. Cover current state, target state, diagrams, scalability, security, observability, migration steps, risks, and unresolved decisions.
Best Practices
- Provide real system context, constraints, and known trade-offs before asking for documentation.
- Ask for diagrams as descriptions first, then convert them into your team's preferred diagram format.
- Review generated ADRs with engineering, security, product, and operations stakeholders.
Avoid
- Do not publish generated architecture documents without checking them against the actual system.
- Do not hide uncertainty; mark assumptions, unknowns, and decisions that still need review.
- Do not use architecture documentation as a substitute for threat modeling or compliance review.
Frequently Asked Questions
What does this skill help create?
Can it analyze my repository automatically?
Does it generate diagrams?
Is it useful for Architecture Decision Records?
Who should review the output?
What information should I provide?
Developer Details
Author
CuriousLearnerLicense
MIT
Skillstore revision
r1
Version notice
The author did not declare a version.
Ref
d11af420e07cd866fe39cfa937efef3223896c06
Maintenance freshness
7/20/2026
Usage
5 downloads · 377 views
File structure
📄 SKILL.md