cybersec-superpowers 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. cybersec_superpowers-0.1.0/.claude-plugin/plugin.json +26 -0
  2. cybersec_superpowers-0.1.0/.opencode/INSTALL.md +75 -0
  3. cybersec_superpowers-0.1.0/LICENSE +21 -0
  4. cybersec_superpowers-0.1.0/MANIFEST.in +18 -0
  5. cybersec_superpowers-0.1.0/PKG-INFO +204 -0
  6. cybersec_superpowers-0.1.0/README.md +177 -0
  7. cybersec_superpowers-0.1.0/VERSION +1 -0
  8. cybersec_superpowers-0.1.0/artifacts/reports/SECURITY_SCAN.md +32 -0
  9. cybersec_superpowers-0.1.0/artifacts/reports/example-incident-playbook.md +136 -0
  10. cybersec_superpowers-0.1.0/artifacts/reports/example-pentest-plan.md +123 -0
  11. cybersec_superpowers-0.1.0/artifacts/reports/example-security-checklist.md +38 -0
  12. cybersec_superpowers-0.1.0/artifacts/reports/example-security-scan-report.md +64 -0
  13. cybersec_superpowers-0.1.0/artifacts/reports/example-stride-model.md +103 -0
  14. cybersec_superpowers-0.1.0/artifacts/reports/stride-model.md +76 -0
  15. cybersec_superpowers-0.1.0/artifacts/sbom/example-sbom-report.json +357 -0
  16. cybersec_superpowers-0.1.0/assets/README.md +43 -0
  17. cybersec_superpowers-0.1.0/assets/demo-screenshot.png +13 -0
  18. cybersec_superpowers-0.1.0/assets/demo.gif +15 -0
  19. cybersec_superpowers-0.1.0/docs/adr/0001-record-architecture-decisions.md +17 -0
  20. cybersec_superpowers-0.1.0/docs/adr/0002-cybersecurity-skill-architecture.md +25 -0
  21. cybersec_superpowers-0.1.0/docs/adr/0003-harness-agnostic-deployment.md +24 -0
  22. cybersec_superpowers-0.1.0/docs/adr/0004-external-tool-invocation-pattern.md +19 -0
  23. cybersec_superpowers-0.1.0/docs/adr/0004-multi-agent-orchestration.md +31 -0
  24. cybersec_superpowers-0.1.0/docs/architecture/c4-component.md +62 -0
  25. cybersec_superpowers-0.1.0/docs/architecture/c4-container.md +64 -0
  26. cybersec_superpowers-0.1.0/docs/architecture/c4-context.md +62 -0
  27. cybersec_superpowers-0.1.0/docs/architecture/sequence-diagrams.md +107 -0
  28. cybersec_superpowers-0.1.0/docs/good-first-issues.md +187 -0
  29. cybersec_superpowers-0.1.0/examples/demo-project/README.md +29 -0
  30. cybersec_superpowers-0.1.0/examples/demo-project/app.js +41 -0
  31. cybersec_superpowers-0.1.0/examples/demo-project/package.json +13 -0
  32. cybersec_superpowers-0.1.0/examples/demo-project/run-demo.sh +51 -0
  33. cybersec_superpowers-0.1.0/hooks/pre-commit/dependency-audit.sh +127 -0
  34. cybersec_superpowers-0.1.0/hooks/pre-commit/secret-scan.sh +112 -0
  35. cybersec_superpowers-0.1.0/hooks/pre-commit/static-analysis.sh +134 -0
  36. cybersec_superpowers-0.1.0/hooks/pre-push/compliance-check.sh +148 -0
  37. cybersec_superpowers-0.1.0/hooks/pre-push/threat-model-validate.sh +106 -0
  38. cybersec_superpowers-0.1.0/marketing/linkedin-post.txt +49 -0
  39. cybersec_superpowers-0.1.0/marketing/loom-script.txt +77 -0
  40. cybersec_superpowers-0.1.0/pyproject.toml +42 -0
  41. cybersec_superpowers-0.1.0/scripts/generate-sbom.sh +264 -0
  42. cybersec_superpowers-0.1.0/scripts/init-project.sh +207 -0
  43. cybersec_superpowers-0.1.0/scripts/install-tools.sh +33 -0
  44. cybersec_superpowers-0.1.0/scripts/run-clear-eval.sh +325 -0
  45. cybersec_superpowers-0.1.0/scripts/run-orchestrator.sh +98 -0
  46. cybersec_superpowers-0.1.0/scripts/run-security-suite.sh +74 -0
  47. cybersec_superpowers-0.1.0/scripts/setup.sh +102 -0
  48. cybersec_superpowers-0.1.0/setup.cfg +4 -0
  49. cybersec_superpowers-0.1.0/skills/cybersecurity/incident-response/SKILL.md +72 -0
  50. cybersec_superpowers-0.1.0/skills/cybersecurity/incident-response/references/nist-800-61.md +26 -0
  51. cybersec_superpowers-0.1.0/skills/cybersecurity/incident-response/run.sh +512 -0
  52. cybersec_superpowers-0.1.0/skills/cybersecurity/incident-response/templates/communication-template.md +67 -0
  53. cybersec_superpowers-0.1.0/skills/cybersecurity/incident-response/templates/incident-playbook.md +60 -0
  54. cybersec_superpowers-0.1.0/skills/cybersecurity/incident-response/templates/lessons-learned.md +27 -0
  55. cybersec_superpowers-0.1.0/skills/cybersecurity/penetration-testing/SKILL.md +87 -0
  56. cybersec_superpowers-0.1.0/skills/cybersecurity/penetration-testing/references/owasp-wstg.md +18 -0
  57. cybersec_superpowers-0.1.0/skills/cybersecurity/penetration-testing/references/ptes-checklist.md +37 -0
  58. cybersec_superpowers-0.1.0/skills/cybersecurity/penetration-testing/run.sh +200 -0
  59. cybersec_superpowers-0.1.0/skills/cybersecurity/penetration-testing/templates/mitre-attack-plan.md +17 -0
  60. cybersec_superpowers-0.1.0/skills/cybersecurity/penetration-testing/templates/owasp-wstg-mapping.md +21 -0
  61. cybersec_superpowers-0.1.0/skills/cybersecurity/penetration-testing/templates/pentest-plan.md +95 -0
  62. cybersec_superpowers-0.1.0/skills/cybersecurity/secure-coding/SKILL.md +59 -0
  63. cybersec_superpowers-0.1.0/skills/cybersecurity/secure-coding/checklists/go.md +12 -0
  64. cybersec_superpowers-0.1.0/skills/cybersecurity/secure-coding/checklists/javascript.md +12 -0
  65. cybersec_superpowers-0.1.0/skills/cybersecurity/secure-coding/checklists/python.md +12 -0
  66. cybersec_superpowers-0.1.0/skills/cybersecurity/secure-coding/checklists/rust.md +12 -0
  67. cybersec_superpowers-0.1.0/skills/cybersecurity/secure-coding/checklists/typescript.md +10 -0
  68. cybersec_superpowers-0.1.0/skills/cybersecurity/secure-coding/run.sh +147 -0
  69. cybersec_superpowers-0.1.0/skills/cybersecurity/secure-coding/templates/security-checklist.md +21 -0
  70. cybersec_superpowers-0.1.0/skills/cybersecurity/static-analysis/SKILL.md +96 -0
  71. cybersec_superpowers-0.1.0/skills/cybersecurity/static-analysis/run.sh +429 -0
  72. cybersec_superpowers-0.1.0/skills/cybersecurity/static-analysis/templates/security-scan-report.md +27 -0
  73. cybersec_superpowers-0.1.0/skills/cybersecurity/static-analysis/tools/bandit-config.yaml +19 -0
  74. cybersec_superpowers-0.1.0/skills/cybersecurity/static-analysis/tools/gosec-config.yaml +21 -0
  75. cybersec_superpowers-0.1.0/skills/cybersecurity/static-analysis/tools/npm-audit.sh +8 -0
  76. cybersec_superpowers-0.1.0/skills/cybersecurity/static-analysis/tools/semgrep-rules.yaml +100 -0
  77. cybersec_superpowers-0.1.0/skills/cybersecurity/supply-chain-security/SKILL.md +77 -0
  78. cybersec_superpowers-0.1.0/skills/cybersecurity/supply-chain-security/templates/sbom-report.md +68 -0
  79. cybersec_superpowers-0.1.0/skills/cybersecurity/threat-modeling/SKILL.md +65 -0
  80. cybersec_superpowers-0.1.0/skills/cybersecurity/threat-modeling/run.sh +263 -0
  81. cybersec_superpowers-0.1.0/skills/cybersecurity/threat-modeling/templates/stride-model.md +60 -0
  82. cybersec_superpowers-0.1.0/skills/orchestration/clear-evaluator/SKILL.md +69 -0
  83. cybersec_superpowers-0.1.0/src/cybersec_superpowers/__init__.py +3 -0
  84. cybersec_superpowers-0.1.0/src/cybersec_superpowers/__main__.py +6 -0
  85. cybersec_superpowers-0.1.0/src/cybersec_superpowers/cli.py +126 -0
  86. cybersec_superpowers-0.1.0/src/cybersec_superpowers.egg-info/PKG-INFO +204 -0
  87. cybersec_superpowers-0.1.0/src/cybersec_superpowers.egg-info/SOURCES.txt +101 -0
  88. cybersec_superpowers-0.1.0/src/cybersec_superpowers.egg-info/dependency_links.txt +1 -0
  89. cybersec_superpowers-0.1.0/src/cybersec_superpowers.egg-info/entry_points.txt +2 -0
  90. cybersec_superpowers-0.1.0/src/cybersec_superpowers.egg-info/top_level.txt +1 -0
  91. cybersec_superpowers-0.1.0/tests/fixtures/mock-bandit-output.json +64 -0
  92. cybersec_superpowers-0.1.0/tests/fixtures/mock-semgrep-output.json +86 -0
  93. cybersec_superpowers-0.1.0/tests/run-skill-tests.sh +103 -0
  94. cybersec_superpowers-0.1.0/tests/skills/test_incident_response.sh +121 -0
  95. cybersec_superpowers-0.1.0/tests/skills/test_penetration_testing.sh +99 -0
  96. cybersec_superpowers-0.1.0/tests/skills/test_secure_coding.sh +99 -0
  97. cybersec_superpowers-0.1.0/tests/skills/test_static_analysis.sh +104 -0
  98. cybersec_superpowers-0.1.0/tests/skills/test_threat_modeling.sh +97 -0
  99. cybersec_superpowers-0.1.0/tools/bandit-config.yaml +251 -0
  100. cybersec_superpowers-0.1.0/tools/gitleaks-config.toml +435 -0
  101. cybersec_superpowers-0.1.0/tools/gosec-config.yaml +134 -0
  102. cybersec_superpowers-0.1.0/tools/semgrep-rules.yaml +652 -0
  103. cybersec_superpowers-0.1.0/tools/trivy-config.yaml +300 -0
@@ -0,0 +1,26 @@
1
+ {
2
+ "name": "CyberSecurity Superpowers",
3
+ "description": "A curated set of Claude agent skills for cybersecurity operations including secure coding, static analysis, incident response, compliance auditing, and threat intelligence.",
4
+ "version": "0.1.0",
5
+ "author": "rohit-barui",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "https://github.com/rohit-barui/cybersecurity-superpowers"
9
+ },
10
+ "capabilities": {
11
+ "skills": [
12
+ "secure-coding",
13
+ "static-analysis",
14
+ "incident-response",
15
+ "compliance-audit",
16
+ "threat-intelligence"
17
+ ],
18
+ "tools": true
19
+ },
20
+ "configuration": {
21
+ "claude_code": {
22
+ "auto_attach": true,
23
+ "skill_discovery": "directory-based"
24
+ }
25
+ }
26
+ }
@@ -0,0 +1,75 @@
1
+ # OpenCode Integration for Cybersecurity Superpowers
2
+
3
+ ## Overview
4
+
5
+ This guide explains how to install and activate the Cybersecurity Superpowers skills within [OpenCode](https://opencode.ai).
6
+
7
+ > **Prerequisites**: You must have OpenCode installed and configured. See the [OpenCode documentation](https://opencode.ai/docs) for setup instructions.
8
+
9
+ ## Installation
10
+
11
+ 1. Clone this repository to your local machine:
12
+ ```bash
13
+ git clone https://github.com/rohit-barui/CyberSecurity-Superpowers.git
14
+ cd CyberSecurity-Superpowers
15
+ ```
16
+
17
+ 2. Run the setup script to verify the environment:
18
+ ```bash
19
+ bash scripts/setup.sh
20
+ ```
21
+
22
+ 3. Configure OpenCode to recognize the skills. Add the following to your OpenCode configuration file (typically `~/.config/opencode/opencode.json` or project-local `.opencode/opencode.json`):
23
+
24
+ ```json
25
+ {
26
+ "agents": {
27
+ "cybersecurity-superpowers": {
28
+ "path": "/path/to/CyberSecurity-Superpowers",
29
+ "auto_load": true
30
+ }
31
+ }
32
+ }
33
+ ```
34
+
35
+ ## Activating Skills
36
+
37
+ Skills are automatically discovered from the `skills/cybersecurity/` directory. OpenCode will load the following skills:
38
+
39
+ | Skill | Description |
40
+ |----------------------|------------------------------------------------|
41
+ | threat-modeling | STRIDE-based threat analysis with CVSS scoring |
42
+ | secure-coding | Language-specific OWASP security checklists |
43
+ | static-analysis | SAST and dependency vulnerability scanning |
44
+ | penetration-testing | Scoped red-team plan generation |
45
+ | incident-response | NIST-aligned incident response playbooks |
46
+ | supply-chain-security | SBOM generation and supply chain scanning |
47
+
48
+ ## Available Scripts
49
+
50
+ | Script | Purpose |
51
+ |--------|---------|
52
+ | `scripts/run-orchestrator.sh` | Multi-skill pipeline with `implement`, `threat-model`, `full` modes |
53
+ | `scripts/run-security-suite.sh` | Batch runner for all 5 core skills |
54
+ | `scripts/setup.sh` | Environment verification |
55
+ | `scripts/init-project.sh` | Directory creation and hook installation |
56
+ | `scripts/generate-sbom.sh` | SBOM generation |
57
+ | `scripts/run-clear-eval.sh` | CLEAR framework project evaluation |
58
+
59
+ ## Verification
60
+
61
+ To verify that skills are properly loaded:
62
+
63
+ ```bash
64
+ opencode agent list
65
+ ```
66
+
67
+ You should see `cybersecurity-superpowers` in the list of available agents.
68
+
69
+ ## Uninstalling
70
+
71
+ Remove the agent configuration from your OpenCode config file, or delete this repository.
72
+
73
+ ---
74
+
75
+ For full documentation, see the [main README](README.md).
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Rohit Barui
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,18 @@
1
+ include VERSION
2
+ include README.md
3
+ include LICENSE
4
+ recursive-include scripts/ *.sh
5
+ recursive-include skills/cybersecurity/ *
6
+ recursive-include skills/orchestration/ *
7
+ recursive-include tools/ *
8
+ recursive-include hooks/ *.sh
9
+ recursive-include tests/ *.sh
10
+ recursive-include tests/ *.json
11
+ recursive-include examples/demo-project/ *
12
+ recursive-include artifacts/reports/ *.md
13
+ recursive-include artifacts/sbom/ *.json
14
+ recursive-include docs/ *
15
+ recursive-include assets/ *
16
+ recursive-include marketing/ *
17
+ recursive-include .claude-plugin/ *
18
+ recursive-include .opencode/ *
@@ -0,0 +1,204 @@
1
+ Metadata-Version: 2.4
2
+ Name: cybersec-superpowers
3
+ Version: 0.1.0
4
+ Summary: Enterprise-grade cybersecurity orchestration platform — STRIDE threat modeling, OWASP secure coding, SAST, pentest plans, incident response playbooks, and SBOM supply-chain security as composable agent skills
5
+ Author-email: Rohit Barui <rohit.barui@example.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/rohit-barui/CyberSecurity-Superpowers
8
+ Project-URL: Repository, https://github.com/rohit-barui/CyberSecurity-Superpowers
9
+ Project-URL: Documentation, https://github.com/rohit-barui/CyberSecurity-Superpowers#readme
10
+ Project-URL: Issues, https://github.com/rohit-barui/CyberSecurity-Superpowers/issues
11
+ Keywords: cybersecurity,devsecops,threat-modeling,secure-coding,incident-response,sast,sbom,owasp
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Intended Audience :: Information Technology
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Operating System :: POSIX
17
+ Classifier: Operating System :: MacOS
18
+ Classifier: Programming Language :: Python :: 3
19
+ Classifier: Programming Language :: Unix Shell
20
+ Classifier: Topic :: Security
21
+ Classifier: Topic :: Software Development :: Build Tools
22
+ Classifier: Topic :: System :: Systems Administration
23
+ Requires-Python: >=3.8
24
+ Description-Content-Type: text/markdown
25
+ License-File: LICENSE
26
+ Dynamic: license-file
27
+
28
+ # 🛡️ CyberSecurity Superpowers
29
+
30
+ > **The Ultimate Enterprise DevSecOps & Cybersecurity Extension for AI Coding Agents.**
31
+ > Embed automated threat modeling, secure coding, SAST scanning, red-team penetration testing, NIST incident response, and supply-chain security into any agentic workflow.
32
+
33
+ [![CI Pipeline](https://github.com/rohit-barui/CyberSecurity-Superpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/rohit-barui/CyberSecurity-Superpowers/actions/workflows/ci.yml)
34
+ [![Release](https://github.com/rohit-barui/CyberSecurity-Superpowers/actions/workflows/release.yml/badge.svg)](https://github.com/rohit-barui/CyberSecurity-Superpowers/actions/workflows/release.yml)
35
+ [![PyPI](https://img.shields.io/badge/pypi-cybersec--superpowers-blue?style=flat-square&logo=pypi)](https://pypi.org/project/cybersec-superpowers/)
36
+ [![Skills](https://img.shields.io/badge/superpowers-6_core_skills-007ACC?style=flat-square&logo=shield)](https://github.com/rohit-barui/CyberSecurity-Superpowers)
37
+ [![Version](https://img.shields.io/badge/version-v0.1.0-brightgreen?style=flat-square)](https://github.com/rohit-barui/CyberSecurity-Superpowers/releases)
38
+ [![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
39
+ [![Standards](https://img.shields.io/badge/standards-OWASP_|_NIST_|_MITRE_ATT%26CK-orange?style=flat-square)](https://github.com/rohit-barui/CyberSecurity-Superpowers)
40
+
41
+ ---
42
+
43
+ ## ⚡ Why CyberSecurity Superpowers is THE Go-To Skill Set
44
+
45
+ AI coding assistants are faster than ever at writing code — but speed without security creates vulnerabilities at scale. **CyberSecurity Superpowers** transforms any AI assistant (Claude Code, Gemini CLI, Cursor, OpenCode, Copilot) into an autonomous **CISO-grade DevSecOps engineer**.
46
+
47
+ ### 🌟 Key Differentiators & Benefits
48
+
49
+ * 🎯 **360° SDLC Security Coverage**: From pre-code threat modeling to post-breach incident playbooks, cover every phase of security automatically.
50
+ * 🤖 **Autonomous ReAct Orchestrator**: Intelligently routes tasks to specific security skill modules without manual intervention.
51
+ * 🏆 **Industry-Standard Alignment**: Native integration with **OWASP Top 10**, **OWASP WSTG**, **MITRE ATT&CK**, **NIST SP 800-61**, **CVSS v3.1**, and **CycloneDX/SPDX**.
52
+ * 🌐 **Harness-Agnostic & Zero Lock-in**: Works out of the box with any LLM, CLI, or agent runtime on Linux, macOS, and Windows.
53
+ * 📊 **Audit-Ready Artifact Generation**: Automatically generates structured, version-controlled Markdown & JSON reports in `artifacts/reports/`.
54
+
55
+ ---
56
+
57
+ ## 🚀 Quickstart
58
+
59
+ Get up and running in 30 seconds. Choose your install method:
60
+
61
+ ### 📦 One-Click Install (curl | bash)
62
+
63
+ ```bash
64
+ curl -sSL https://raw.githubusercontent.com/rohit-barui/CyberSecurity-Superpowers/main/install.sh | bash
65
+ cybersec demo
66
+ ```
67
+
68
+ ### 🐍 PyPI (pip / pipx)
69
+
70
+ ```bash
71
+ pipx install cybersec-superpowers
72
+ # or: pip install --user cybersec-superpowers
73
+ cybersec threat-model "My App"
74
+ ```
75
+
76
+ ### 📁 Git Clone
77
+
78
+ ```bash
79
+ git clone https://github.com/rohit-barui/CyberSecurity-Superpowers.git
80
+ cd CyberSecurity-Superpowers
81
+ bash scripts/setup.sh
82
+ bash examples/demo-project/run-demo.sh
83
+ ```
84
+
85
+ ---
86
+
87
+ ## 🧩 The 6 Core Cybersecurity Superpowers
88
+
89
+ | Superpower | Description | Industry Standard | Output Artifact |
90
+ |---|---|---|---|
91
+ | 🧠 **Threat Modeling** | Automated STRIDE threat analysis, trust boundary mapping, & CVSS v3.1 risk scoring | NIST SP 800-53 / OWASP ASVS | `artifacts/reports/stride-model.md` |
92
+ | 🛡️ **Secure Coding** | Language-specific security checklist enforcement (JS, TS, Python, Go, Rust) | OWASP Top 10 | `artifacts/reports/SECURITY.md` |
93
+ | 🔍 **Static Analysis (SAST)** | Multi-engine SAST & dependency vulnerability scanning (Semgrep, Bandit, Gosec, NPM Audit) | SARIF / CWE / CVE | `artifacts/reports/SECURITY_SCAN.md` |
94
+ | ⚔️ **Penetration Testing** | Scoped red-team attack plan generator mapped to offensive tactics | MITRE ATT&CK & OWASP WSTG | `artifacts/reports/pentest-plan.md` |
95
+ | 🚨 **Incident Response** | Incident playbook generator for Ransomware, Data Breach, Phishing, DDoS, & Insider Threats | NIST SP 800-61 Rev. 2 | `artifacts/reports/incident-playbook.md` |
96
+ | 📦 **Supply-Chain Security** | Automated SBOM generation (CycloneDX / SPDX) and dependency vulnerability audit | NTIA Minimum Elements | `artifacts/sbom/sbom-report.json` |
97
+
98
+ ---
99
+
100
+ ## 🏗️ Architecture & Orchestration
101
+
102
+ The system utilizes an autonomous **ReAct Orchestrator** (`scripts/run-orchestrator.sh`) that accepts natural language intent or CLI modes and routes them across the underlying security modules:
103
+
104
+ ```
105
+ ┌───────────────────────────────┐
106
+ │ User / AI Agent Intent │
107
+ └───────────────┬───────────────┘
108
+ │
109
+ ▼
110
+ ┌───────────────────────────────┐
111
+ │ ReAct Orchestrator │
112
+ │ (scripts/run-orchestrator) │
113
+ └───────────────┬───────────────┘
114
+ │
115
+ ┌───────────────┬───────────┼───────────┬───────────────┐
116
+ ▼ ▼ ▼ ▼ ▼
117
+ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐
118
+ │ Threat │ │ Secure │ │ Static │ │ Pentest │ │ Incident │
119
+ │ Modeling │ │ Coding │ │ Analysis │ │ Plan │ │ Response │
120
+ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
121
+ │ │ │ │ │
122
+ └───────────────┴───────────┼───────────┴───────────────┘
123
+ │
124
+ ▼
125
+ ┌───────────────────────────────┐
126
+ │ Audit-Ready Markdown & JSON │
127
+ │ (artifacts/reports/*.md) │
128
+ └───────────────────────────────┘
129
+ ```
130
+
131
+ ---
132
+
133
+ ## 💻 Usage & CLI Examples
134
+
135
+ ### Automated Orchestration
136
+
137
+ ```bash
138
+ # Run Secure Coding + SAST on current codebase
139
+ bash scripts/run-orchestrator.sh implement "Authentication microservice"
140
+
141
+ # Generate complete Threat Model for a project
142
+ bash scripts/run-orchestrator.sh threat-model "Payment Gateway API"
143
+
144
+ # Run full 5-phase security suite
145
+ bash scripts/run-orchestrator.sh full "Production Release Candidate"
146
+ ```
147
+
148
+ ### Direct Skill Execution
149
+
150
+ ```bash
151
+ # Threat Modeling
152
+ bash skills/cybersecurity/threat-modeling/run.sh --project "E-Commerce System"
153
+
154
+ # Secure Coding Checklists
155
+ bash skills/cybersecurity/secure-coding/run.sh --language python --target-dir ./src
156
+
157
+ # Static Analysis (SAST)
158
+ bash skills/cybersecurity/static-analysis/run.sh --target-dir ./src --format md
159
+
160
+ # Penetration Testing Plan
161
+ bash skills/cybersecurity/penetration-testing/run.sh --target-app "Portal API" --scope web
162
+
163
+ # Incident Response Playbook
164
+ bash skills/cybersecurity/incident-response/run.sh --incident-type ransomware
165
+
166
+ # Supply Chain SBOM Generation
167
+ bash scripts/generate-sbom.sh --target-dir .
168
+ ```
169
+
170
+ ### Git Hooks & DevSecOps Automation
171
+
172
+ Protect your main branch automatically before commits and pushes:
173
+
174
+ ```bash
175
+ # Install automated Git hooks (Pre-commit SAST & Pre-push security gates)
176
+ bash scripts/init-project.sh
177
+ ```
178
+
179
+ ---
180
+
181
+ ## 🛡️ CI/CD Pipeline
182
+
183
+ Every commit and pull request is automatically validated by GitHub Actions (`.github/workflows/ci.yml`):
184
+
185
+ * ✅ **Lint & Frontmatter Validation**: ShellCheck, Yamllint, and `SKILL.md` spec validation.
186
+ * ✅ **Automated Skill Tests**: End-to-end unit test execution across all 6 superpowers (`tests/run-skill-tests.sh`).
187
+ * ✅ **Orchestrator Verification**: Live execution check of the orchestrator pipeline.
188
+ * ✅ **Security Gate Build**: Summary matrix validation with non-zero exit enforcement on failure.
189
+
190
+ ---
191
+
192
+ ## 👥 Contributing
193
+
194
+ We welcome community contributions! Check out our [Good First Issues](docs/good-first-issues.md) and review [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
195
+
196
+ ---
197
+
198
+ ## 📄 License
199
+
200
+ This project is licensed under the [MIT License](LICENSE). Feel free to use, adapt, and build upon it!
201
+
202
+ ---
203
+
204
+ *Built with ❤️ for the AI Security & DevSecOps Community.*
@@ -0,0 +1,177 @@
1
+ # 🛡️ CyberSecurity Superpowers
2
+
3
+ > **The Ultimate Enterprise DevSecOps & Cybersecurity Extension for AI Coding Agents.**
4
+ > Embed automated threat modeling, secure coding, SAST scanning, red-team penetration testing, NIST incident response, and supply-chain security into any agentic workflow.
5
+
6
+ [![CI Pipeline](https://github.com/rohit-barui/CyberSecurity-Superpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/rohit-barui/CyberSecurity-Superpowers/actions/workflows/ci.yml)
7
+ [![Release](https://github.com/rohit-barui/CyberSecurity-Superpowers/actions/workflows/release.yml/badge.svg)](https://github.com/rohit-barui/CyberSecurity-Superpowers/actions/workflows/release.yml)
8
+ [![PyPI](https://img.shields.io/badge/pypi-cybersec--superpowers-blue?style=flat-square&logo=pypi)](https://pypi.org/project/cybersec-superpowers/)
9
+ [![Skills](https://img.shields.io/badge/superpowers-6_core_skills-007ACC?style=flat-square&logo=shield)](https://github.com/rohit-barui/CyberSecurity-Superpowers)
10
+ [![Version](https://img.shields.io/badge/version-v0.1.0-brightgreen?style=flat-square)](https://github.com/rohit-barui/CyberSecurity-Superpowers/releases)
11
+ [![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
12
+ [![Standards](https://img.shields.io/badge/standards-OWASP_|_NIST_|_MITRE_ATT%26CK-orange?style=flat-square)](https://github.com/rohit-barui/CyberSecurity-Superpowers)
13
+
14
+ ---
15
+
16
+ ## ⚡ Why CyberSecurity Superpowers is THE Go-To Skill Set
17
+
18
+ AI coding assistants are faster than ever at writing code — but speed without security creates vulnerabilities at scale. **CyberSecurity Superpowers** transforms any AI assistant (Claude Code, Gemini CLI, Cursor, OpenCode, Copilot) into an autonomous **CISO-grade DevSecOps engineer**.
19
+
20
+ ### 🌟 Key Differentiators & Benefits
21
+
22
+ * 🎯 **360° SDLC Security Coverage**: From pre-code threat modeling to post-breach incident playbooks, cover every phase of security automatically.
23
+ * 🤖 **Autonomous ReAct Orchestrator**: Intelligently routes tasks to specific security skill modules without manual intervention.
24
+ * 🏆 **Industry-Standard Alignment**: Native integration with **OWASP Top 10**, **OWASP WSTG**, **MITRE ATT&CK**, **NIST SP 800-61**, **CVSS v3.1**, and **CycloneDX/SPDX**.
25
+ * 🌐 **Harness-Agnostic & Zero Lock-in**: Works out of the box with any LLM, CLI, or agent runtime on Linux, macOS, and Windows.
26
+ * 📊 **Audit-Ready Artifact Generation**: Automatically generates structured, version-controlled Markdown & JSON reports in `artifacts/reports/`.
27
+
28
+ ---
29
+
30
+ ## 🚀 Quickstart
31
+
32
+ Get up and running in 30 seconds. Choose your install method:
33
+
34
+ ### 📦 One-Click Install (curl | bash)
35
+
36
+ ```bash
37
+ curl -sSL https://raw.githubusercontent.com/rohit-barui/CyberSecurity-Superpowers/main/install.sh | bash
38
+ cybersec demo
39
+ ```
40
+
41
+ ### 🐍 PyPI (pip / pipx)
42
+
43
+ ```bash
44
+ pipx install cybersec-superpowers
45
+ # or: pip install --user cybersec-superpowers
46
+ cybersec threat-model "My App"
47
+ ```
48
+
49
+ ### 📁 Git Clone
50
+
51
+ ```bash
52
+ git clone https://github.com/rohit-barui/CyberSecurity-Superpowers.git
53
+ cd CyberSecurity-Superpowers
54
+ bash scripts/setup.sh
55
+ bash examples/demo-project/run-demo.sh
56
+ ```
57
+
58
+ ---
59
+
60
+ ## 🧩 The 6 Core Cybersecurity Superpowers
61
+
62
+ | Superpower | Description | Industry Standard | Output Artifact |
63
+ |---|---|---|---|
64
+ | 🧠 **Threat Modeling** | Automated STRIDE threat analysis, trust boundary mapping, & CVSS v3.1 risk scoring | NIST SP 800-53 / OWASP ASVS | `artifacts/reports/stride-model.md` |
65
+ | 🛡️ **Secure Coding** | Language-specific security checklist enforcement (JS, TS, Python, Go, Rust) | OWASP Top 10 | `artifacts/reports/SECURITY.md` |
66
+ | 🔍 **Static Analysis (SAST)** | Multi-engine SAST & dependency vulnerability scanning (Semgrep, Bandit, Gosec, NPM Audit) | SARIF / CWE / CVE | `artifacts/reports/SECURITY_SCAN.md` |
67
+ | ⚔️ **Penetration Testing** | Scoped red-team attack plan generator mapped to offensive tactics | MITRE ATT&CK & OWASP WSTG | `artifacts/reports/pentest-plan.md` |
68
+ | 🚨 **Incident Response** | Incident playbook generator for Ransomware, Data Breach, Phishing, DDoS, & Insider Threats | NIST SP 800-61 Rev. 2 | `artifacts/reports/incident-playbook.md` |
69
+ | 📦 **Supply-Chain Security** | Automated SBOM generation (CycloneDX / SPDX) and dependency vulnerability audit | NTIA Minimum Elements | `artifacts/sbom/sbom-report.json` |
70
+
71
+ ---
72
+
73
+ ## 🏗️ Architecture & Orchestration
74
+
75
+ The system utilizes an autonomous **ReAct Orchestrator** (`scripts/run-orchestrator.sh`) that accepts natural language intent or CLI modes and routes them across the underlying security modules:
76
+
77
+ ```
78
+ ┌───────────────────────────────┐
79
+ │ User / AI Agent Intent │
80
+ └───────────────┬───────────────┘
81
+ │
82
+ ▼
83
+ ┌───────────────────────────────┐
84
+ │ ReAct Orchestrator │
85
+ │ (scripts/run-orchestrator) │
86
+ └───────────────┬───────────────┘
87
+ │
88
+ ┌───────────────┬───────────┼───────────┬───────────────┐
89
+ ▼ ▼ ▼ ▼ ▼
90
+ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐
91
+ │ Threat │ │ Secure │ │ Static │ │ Pentest │ │ Incident │
92
+ │ Modeling │ │ Coding │ │ Analysis │ │ Plan │ │ Response │
93
+ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
94
+ │ │ │ │ │
95
+ └───────────────┴───────────┼───────────┴───────────────┘
96
+ │
97
+ ▼
98
+ ┌───────────────────────────────┐
99
+ │ Audit-Ready Markdown & JSON │
100
+ │ (artifacts/reports/*.md) │
101
+ └───────────────────────────────┘
102
+ ```
103
+
104
+ ---
105
+
106
+ ## 💻 Usage & CLI Examples
107
+
108
+ ### Automated Orchestration
109
+
110
+ ```bash
111
+ # Run Secure Coding + SAST on current codebase
112
+ bash scripts/run-orchestrator.sh implement "Authentication microservice"
113
+
114
+ # Generate complete Threat Model for a project
115
+ bash scripts/run-orchestrator.sh threat-model "Payment Gateway API"
116
+
117
+ # Run full 5-phase security suite
118
+ bash scripts/run-orchestrator.sh full "Production Release Candidate"
119
+ ```
120
+
121
+ ### Direct Skill Execution
122
+
123
+ ```bash
124
+ # Threat Modeling
125
+ bash skills/cybersecurity/threat-modeling/run.sh --project "E-Commerce System"
126
+
127
+ # Secure Coding Checklists
128
+ bash skills/cybersecurity/secure-coding/run.sh --language python --target-dir ./src
129
+
130
+ # Static Analysis (SAST)
131
+ bash skills/cybersecurity/static-analysis/run.sh --target-dir ./src --format md
132
+
133
+ # Penetration Testing Plan
134
+ bash skills/cybersecurity/penetration-testing/run.sh --target-app "Portal API" --scope web
135
+
136
+ # Incident Response Playbook
137
+ bash skills/cybersecurity/incident-response/run.sh --incident-type ransomware
138
+
139
+ # Supply Chain SBOM Generation
140
+ bash scripts/generate-sbom.sh --target-dir .
141
+ ```
142
+
143
+ ### Git Hooks & DevSecOps Automation
144
+
145
+ Protect your main branch automatically before commits and pushes:
146
+
147
+ ```bash
148
+ # Install automated Git hooks (Pre-commit SAST & Pre-push security gates)
149
+ bash scripts/init-project.sh
150
+ ```
151
+
152
+ ---
153
+
154
+ ## 🛡️ CI/CD Pipeline
155
+
156
+ Every commit and pull request is automatically validated by GitHub Actions (`.github/workflows/ci.yml`):
157
+
158
+ * ✅ **Lint & Frontmatter Validation**: ShellCheck, Yamllint, and `SKILL.md` spec validation.
159
+ * ✅ **Automated Skill Tests**: End-to-end unit test execution across all 6 superpowers (`tests/run-skill-tests.sh`).
160
+ * ✅ **Orchestrator Verification**: Live execution check of the orchestrator pipeline.
161
+ * ✅ **Security Gate Build**: Summary matrix validation with non-zero exit enforcement on failure.
162
+
163
+ ---
164
+
165
+ ## 👥 Contributing
166
+
167
+ We welcome community contributions! Check out our [Good First Issues](docs/good-first-issues.md) and review [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
168
+
169
+ ---
170
+
171
+ ## 📄 License
172
+
173
+ This project is licensed under the [MIT License](LICENSE). Feel free to use, adapt, and build upon it!
174
+
175
+ ---
176
+
177
+ *Built with ❤️ for the AI Security & DevSecOps Community.*
@@ -0,0 +1 @@
1
+ 0.1.0
@@ -0,0 +1,32 @@
1
+ # Security Scan Report
2
+
3
+ ## Project: Cybersecurity Superpowers
4
+ ## Date: 2026-08-16
5
+ ## Tools Used:
6
+
7
+ ## Summary
8
+
9
+ | Severity | Count |
10
+ |----------|-------|
11
+ | Critical | 0 |
12
+ | High | 0 |
13
+ | Medium | 0 |
14
+ | Low | 0 |
15
+ | Info | 0 |
16
+
17
+ ## Findings
18
+
19
+ | ID | Tool | Type | Location | Severity | Description | Remediation |
20
+ |----|------|------|----------|----------|-------------|-------------|
21
+
22
+ ## Tool Results
23
+
24
+ ### npm audit
25
+ [Summary of results]
26
+
27
+ ### Bandit
28
+ [Summary of results]
29
+
30
+ ## Next Steps
31
+
32
+ [Actions to take for each finding]