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 2 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.
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.
Security News
Cloudflare introduces tsrs, a Rust port of TypeScript’s compiler promising faster checks and lower memory use, with the TypeScript team’s help.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.