engineering-docs
Advanced tools
11 world-class engineering documentation skills covering the complete software lifecycle: spec, feasibility, architecture, design, API, database, ADR, security, deployment, operations, and incident review.
11 world-class engineering documentation skills for AI coding agents. Auto-triggers on user intent. No manual selection needed.
Built to the standard of a 20+ year senior engineer. Grounded in ISO/IEC/IEEE 29148, C4 Model, ADR Pattern, STRIDE Threat Modeling, OpenAPI 3.1, Google SRE Runbook standards, and blameless post-mortem culture.
| # | Skill | What It Produces | When It Triggers |
|---|---|---|---|
| 1 | technical-specification | SRS / TSD (requirements document) | "write a spec for...", "requirements for..." |
| 2 | technical-feasibility-study | Technical feasibility assessment | "is this feasible?", "PoC for...", "can we build..." |
| 3 | system-architecture-document | SAD with C4 diagrams + ADR log | "document the architecture of...", "C4 diagram for..." |
| 4 | technical-blueprint | TDD / SDD (design doc) | "design this feature...", "how do we build..." |
| 5 | api-design-document | OpenAPI 3.1 aligned API contract | "design this API...", "REST API spec for..." |
| 6 | database-design-document | ERD + schema + data dictionary | "database design for...", "schema for...", "ERD for..." |
| 7 | architecture-decision-record | Immutable ADR per decision | "document this decision...", "write an ADR for..." |
| 8 | security-threat-model | STRIDE threat model + mitigations | "threat model for...", "security risks of..." |
| 9 | deployment-plan | Release plan + rollback procedure | "deployment plan for...", "how do we release..." |
| 10 | technical-runbook | Production operations runbook | "write a runbook for...", "ops manual for..." |
| 11 | incident-postmortem | Blameless RCA report | "post-mortem for...", "root cause of..." |
You can run the interactive CLI installer instantly to copy the plugin to your agent's config directory:
npx github:fattain-naime/engineering-docs
The installer will guide you to choose between:
.agents/skills/).cursor/rules/)Clone or copy this folder into your global plugins directory:
git clone https://github.com/fattain-naime/engineering-docs.git ~/.gemini/config/plugins/engineering-docs
You can add this repository as a custom marketplace source directly inside Claude Code:
/plugin marketplace add fattain-naime/engineering-docs
/plugin install engineering-docs
Or copy the folder manually:
git clone https://github.com/fattain-naime/engineering-docs.git ~/.claude/plugins/engineering-docs
Copy the skills/ directory contents into your .cursor/rules/ or .windsurfrules directory, one rule file per skill.
You never need to manually invoke a skill. Simply describe what you need:
"Write a technical specification for a JWT-based authentication service."
"Design the database schema for a multi-tenant SaaS billing system."
"Document our decision to use PostgreSQL instead of MongoDB."
"Write a post-mortem for last night's payment processing outage."
The agent will automatically detect intent and apply the correct skill.
| Skill | Standard |
|---|---|
technical-specification | ISO/IEC/IEEE 29148:2018 |
system-architecture-document | C4 Model, 4+1 View Model (Kruchten), IEEE 1471 |
api-design-document | OpenAPI 3.1, REST Maturity Model (Richardson), AsyncAPI 2.x |
architecture-decision-record | ADR Pattern (Michael Nygard), MADR |
security-threat-model | STRIDE (Microsoft SDL), OWASP Threat Modeling |
technical-runbook | Google SRE Book, ITIL v4 |
incident-postmortem | Google SRE Blameless Post-mortem Culture |
deployment-plan | DORA Metrics, Blue-Green / Canary / Rolling deployment patterns |
engineering-docs is optimized and fully compatible with all major agentic frameworks:
| Platform | Manifest File | Directory / Target |
|---|---|---|
| Gemini (Antigravity) | gemini-extension.json & GEMINI.md | ~/.gemini/config/plugins/ |
| Claude Code | .claude-plugin/plugin.json | ~/.claude/plugins/ |
| Cursor / Windsurf | .cursor-plugin/plugin.json | ./.cursor/rules/ |
| Kimi Code | .kimi-plugin/plugin.json | Local or Global directory |
| Copilot / Codex | .codex-plugin/plugin.json | Root configuration |
See CONTRIBUTING.md for skill authoring standards. Each skill must include:
SKILL.md with valid YAML frontmattertemplate.md that is fully self-guidingMIT. See LICENSE.
FAQs
22 engineering documentation skills covering the complete software lifecycle: business concept, project planning, personas, specs, feasibility, UX flow, architecture, design system, API, database, ADR, access control, security, testing, implementation, de
The npm package engineering-docs receives a total of 0 weekly downloads. As such, engineering-docs popularity was classified as not popular.
We found that engineering-docs demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Product
Socket Threat Intel now shows which malware campaigns were blocked or detected in your organization, with links to scans and Firewall events.
Security News
Fixes for eMudhra and Brotli are out. Getting them everywhere they’re needed means tracking down bundled libraries, runtimes, and certificate stores.
Threat Research
/Security News
Socket uncovered secret-stealing workflows that ran in LiteLLM’s GitHub repository 11 days before the supply chain attack on PyPI and Docker.