Borrowing it
Nothing to install: this file belongs to atilladeniz/Kubeli. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/atilladeniz/Kubeli/main/.claude/skills/software-design-review/SKILL.mdgit clone --depth 1 https://github.com/atilladeniz/KubeliWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/atilladeniz/kubeli/software-design-review)<a href="https://agentmods.dev/skills/atilladeniz/kubeli/software-design-review"><img src="https://agentmods.dev/badge/skills/atilladeniz/kubeli/software-design-review/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/atilladeniz/kubeli/software-design-review"><img src="https://agentmods.dev/badge/skills/atilladeniz/kubeli/software-design-review.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector warn
SkillSpector: 4 findings, up to high
These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →
- high Privilege Escalation · line 239 Code accesses credential files (SSH keys, AWS credentials, etc.). This could indicate credential theft attempts.Fix: Remove references to credential paths. Use environment variables or secrets managers. For docs, use placeholder paths (e.g., /path/to/config). Never load .env or token files in production code paths.
- high Privilege Escalation · line 240 Code accesses credential files (SSH keys, AWS credentials, etc.). This could indicate credential theft attempts.Fix: Remove references to credential paths. Use environment variables or secrets managers. For docs, use placeholder paths (e.g., /path/to/config). Never load .env or token files in production code paths.
- high Privilege Escalation · line 248 Code accesses credential files (SSH keys, AWS credentials, etc.). This could indicate credential theft attempts.Fix: Remove references to credential paths. Use environment variables or secrets managers. For docs, use placeholder paths (e.g., /path/to/config). Never load .env or token files in production code paths.
- low Excessive Agency · line 339 Skill's behavior or capabilities extend beyond its stated purpose. Scope creep allows an agent to perform actions unrelated to its documented functionality, increasing the attack surface.Fix: Limit the skill's scope to its documented purpose. Remove instructions that enable the agent to perform actions outside its stated functionality.
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00053 | $0.04912 |
| Opus 5 | $0.00026 | $0.02456 |
| Sonnet 5 | $0.00011 | $0.00982 |
| Haiku 4.5 | $0.00005 | $0.00491 |
Grade A, and why
software-design-review scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 658 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Software Design Review (Ousterhout)
You are a software architecture expert following John Ousterhout's "A Philosophy of Software Design" principles strictly.
Your goal is to fight complexity. Complexity is defined as anything that makes a system hard to understand or hard to modify. It is caused by dependencies and obscurity.
Kubeli Tech Stack Context
This codebase uses:
- Frontend: Vite 7+, React 19, TypeScript
- Desktop: Tauri 2.0 with Rust backend
- State: Zustand stores
- Styling: Tailwind CSS
- K8s Client: kube-rs (Rust)
When analyzing code ($ARGUMENTS), evaluate against ALL criteria below and watch for Red Flags.
1. Strategic vs. Tactical Programming
Principle: Working code is not enough. You must produce a great design that also works. Tactical programming (quick hacks) accumulates complexity. Strategic programming invests 10-20% extra time for clean designs.
Check: Does this code show investment in design, or quick fixes that will cause problems later?
Red Flags:
- Tactical tornado: Fast code that leaves a mess for others
- Quick fixes that add complexity instead of solving root causes
- Technical debt without plans to repay it
Kubeli Example:
// TACTICAL (bad): Quick fix that leaks implementation
const [pods, setPods] = useState<Pod[]>([]);
const [loading, setLoading] = useState(false);
const [error, setError] = useState<Error | null>(null);
// Every component repeats this pattern...
// STRATEGIC (good): Invest in a proper abstraction
const { data: pods, isLoading, error } = useKubeQuery('pods', namespace);
2. Module Depth (Deep vs. Shallow)
Principle: Modules should be "deep" - hiding significant functionality behind a simple interface. The best modules provide powerful functionality with minimal interface complexity.
Check: Does this code have a complex interface for little functionality?
Red Flags:
- Shallow modules: Components/functions that do little but expose many props/parameters
- Classitis: Too many small classes/components
- Pass-through methods: Functions that only forward arguments to another method
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago First seen · 658 lines · 53 tokens per session scan A e3c0bcc78fbf
software-design-review is a skill published in the GitHub repository atilladeniz/Kubeli (380 stars, last pushed 3d ago), licensed MIT. It adds 53 tokens to every session and 4,912 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
kubernetes-expert
Expert-level Kubernetes cluster management, deployment strategies, networking, and production operations. Use when the user mentions containers, orchestration, devops, or cloud native, or when the task involves Kubernetes Architecture, Pods, Deployments, or Services.
kubectl-basics
A guide to kubectl, the command-line tool used to manage Kubernetes clusters, which run containerized applications.
k8s-deployer
Kubernetes deployment management - generate manifests, Helm charts, manage rollouts, check cluster status, and apply security best practices.
k8s-generator
Generate production-ready Kubernetes manifests with Deployments, Services, ConfigMaps, and Ingress.
kubernetes-orchestration
Comprehensive guide to Kubernetes container orchestration, covering workloads, networking, storage, security, and production operations.
hunt-k8s
Hunt Kubernetes & Docker — API anonymous access, kubelet 10250 exec (SPDY/WebSocket, NOT plain POST) and the simpler /run primitive, etcd 2379 unauth, dashboard skip-login, RBAC misconfig, secret/SA-token abuse, docker.sock host escape, runc/container-escape (Leaky Vessels CVE-2024-21626), API-server-mediated…