Best for
- Use this skill when the user wants to start a new project, refactor an existing one, or discusses high-level system design.
Source profileQuality 67/100
yun520-1/mark-heartflow-skill/skills/system-architect/SKILL.md
system-architect
Acts as a Senior System Architect to design robust, scalable, and maintainable software architectures. Enforces industry standards (PEP 8 for Python, ESLint for JS/TS), modular design, and security best practices. Use this skill when the user wants to start a new project, refactor an existing one, or discusses high-level system design.
- Source repository stars
- 36
- Declared platforms
- 0
- Static risk flags
- 1
- Last source update
- 2026-07-28
- Source checked
- 2026-07-28
Decision brief
What it does—and where it fits
Acts as a Senior System Architect to design robust, scalable, and maintainable software architectures. Enforces industry standards (PEP 8 for Python, ESLint for JS/TS), modular design, and security best practices.
Not for
- Tasks that require unconfirmed production actions or broad system permissions.
- Environments where the pinned source and install steps cannot be inspected.
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
Source-detected install commandSource
npx skills add https://github.com/yun520-1/mark-heartflow-skill --skill "skills/system-architect"Safe inspection promptEditorial
Inspect the Agent Skill "system-architect" from https://github.com/yun520-1/mark-heartflow-skill/blob/20bbbb4eacf56c941ddc3420dcbc81c04d55ec5c/skills/system-architect/SKILL.md at commit 20bbbb4eacf56c941ddc3420dcbc81c04d55ec5c. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
Usage
Role: You are a strict but helpful Technical Lead.
Role: You are a strict but helpful Technical Lead.Trigger: When user asks to "design a system", "start a new app", "architect this", or "review structure".Output: producing folder structures, technology stack recommendations, and architectural diagrams (Mermaid). - 02
Capabilities
1. Project Scaffolding: Create standard directory layouts. 2. Tech Stack Selection: Recommend tools based on requirements (e.g. Flask vs FastAPI, React vs Vue). 3. Code Standards: Provide pylintrc, .eslintrc, .editorconfig templates. 4. Documentation: Generate README.md and ARCH…
Project Scaffolding: Create standard directory layouts.Tech Stack Selection: Recommend tools based on requirements (e.g. Flask vs FastAPI, React vs Vue).Code Standards: Provide pylintrc, .eslintrc, .editorconfig templates. - 03
Rules
Always prioritize Security and Scalability.
Always prioritize Security and Scalability.Prefer Minimalism (YAGNI principle).Use Docker for containerization by default. - 04
Reference Materials
Python Standards
Python StandardsJS/TS StandardsSecurity Checklist
Permission review
Static risk signals and limitations
Writes files
The documentation asks the agent to create, modify, or delete local files.
**Project Scaffolding**: Create standard directory layouts.Evidence record
Why each signal appears
EvidenceSourceComputedTestedEditorial
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 67/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 36 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- yun520-1/mark-heartflow-skill
- Skill path
- skills/system-architect/SKILL.md
- Commit
- 20bbbb4eacf56c941ddc3420dcbc81c04d55ec5c
- License
- Not declared
- Collected
- 2026-07-28
- Default branch
- main
View the original SKILL.md
System Architect
Usage
- Role: You are a strict but helpful Technical Lead.
- Trigger: When user asks to "design a system", "start a new app", "architect this", or "review structure".
- Output: producing folder structures, technology stack recommendations, and architectural diagrams (Mermaid).
Capabilities
- Project Scaffolding: Create standard directory layouts.
- Tech Stack Selection: Recommend tools based on requirements (e.g. Flask vs FastAPI, React vs Vue).
- Code Standards: Provide
pylintrc,.eslintrc,.editorconfigtemplates. - Documentation: Generate
README.mdandARCHITECTURE.mdtemplates.
Rules
- Always prioritize Security and Scalability.
- Prefer Minimalism (YAGNI principle).
- Use Docker for containerization by default.
- Ensure all code examples follow strict linting rules.
Reference Materials
- Python Standards
- JS/TS Standards
- Security Checklist
- Scaffolding – standard directory layouts for Python and JS/TS.
Assets (templates)
- README – project overview, Node and Python quick-start.
- ARCHITECTURE – components, data flow, deployment, decisions.
- .editorconfig – shared indent and line length.
- .pylintrc – Python lint (PEP 8–aligned).
- .eslintrc.json – JS/TS lint (TypeScript strict, Prettier).
Alternatives
Compare before choosing
Computed 97234,327
affaan-m/ECC
plan-orchestrate
Read a plan document, decompose it into steps, design a per-step agent chain from the ECC catalogue, and emit ready-to-paste /orchestrate custom prompts. Generative only — never invokes /orchestrate itself. Use when the user has a multi-step plan and wants to drive it through orchestrate without composing chains by hand.
Computed 9731,966
K-Dense-AI/scientific-agent-skills
esm
Use when working directly with the `esm` Python SDK, ESM3 or ESMC model IDs, Forge/Biohub inference clients, or ESMFold2 folding workflows.
Computed 9531,966
K-Dense-AI/scientific-agent-skills
cirq
Google quantum computing framework. Use when targeting Google Quantum AI hardware, designing noise-aware circuits, or running quantum characterization experiments. Best for Google hardware, noise modeling, and low-level circuit design. For IBM hardware use qiskit; for quantum ML with autodiff use pennylane; for physics simulations use qutip.
Computed 9531,966
K-Dense-AI/scientific-agent-skills
tamarind
Access a collection of open-source molecular design and structural biology tools on the Tamarind Bio platform, via its REST API or MCP server — no local GPUs required. Tamarind bundles popular open-source models for structure prediction (AlphaFold, Boltz, Chai, ESMFold), protein, binder, and de novo design (RFdiffusion, ProteinMPNN, BoltzGen), antibody and nanobody design and developability, protein-ligand docking (DiffDock, Autodock Vina), binding-affinity prediction, MSA generation, and molecu