htlin222/architect
claude.symlink/skills/architect/SKILL.md
Design system architecture, APIs, and component interfaces. Use for architectural decisions and system design.
$ install --global
skillsauthnpx skillsauth add htlin222/dotfiles architectInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 5, 2026, 8:05 PM8.8s1 file scanned
SKILL.md
- name:
- architect
- description:
- Design system architecture, APIs, and component interfaces. Use for architectural decisions and system design.
System Architecture
Design scalable, maintainable system architectures.
When to Use
- Major architectural decisions
- System design discussions
- Evaluating trade-offs
- Planning large refactors
- Reviewing system structure
Design Process
- Understand - Clarify requirements and constraints
- Identify - Define components and boundaries
- Design - Create architecture with trade-offs
- Validate - Check against requirements
- Document - Record decisions and rationale
Architecture Patterns
Layered Architecture
┌─────────────────────────────┐
│ Presentation Layer │ UI, API endpoints
├─────────────────────────────┤
│ Business Layer │ Domain logic, services
├─────────────────────────────┤
│ Persistence Layer │ Repositories, DAOs
├─────────────────────────────┤
│ Data Layer │ Database, cache
└─────────────────────────────┘
Microservices
┌─────────┐ ┌─────────┐ ┌─────────┐
│ User │ │ Order │ │ Payment │
│ Service │ │ Service │ │ Service │
└────┬────┘ └────┬────┘ └────┬────┘
│ │ │
└────────────┼────────────┘
│
┌──────┴──────┐
│ Message Bus │
└─────────────┘
Event-Driven
Producer → Event Bus → Consumer(s)
│
├→ Service A
├→ Service B
└→ Analytics
Decision Framework
Trade-off Analysis
| Aspect | Option A | Option B | | -------------- | -------- | ---------- | | Complexity | Low | High | | Scalability | Limited | Horizontal | | Cost | $ | $$$ | | Time to market | Fast | Slow | | Maintenance | Easy | Complex |
ADR Template
# ADR-001: [Decision Title]
## Status
Accepted | Proposed | Deprecated
## Context
[Why we need to make this decision]
## Decision
[What we decided]
## Consequences
### Positive
- [Benefit 1]
### Negative
- [Trade-off 1]
### Risks
- [Risk 1]
Key Principles
- Separation of Concerns - Each component has one responsibility
- Loose Coupling - Minimize dependencies between components
- High Cohesion - Related functionality grouped together
- YAGNI - Don't build for hypothetical requirements
- Fail Fast - Detect and report errors immediately
Scalability Checklist
- [ ] Stateless services (session in Redis/DB)
- [ ] Horizontal scaling capability
- [ ] Database read replicas
- [ ] Caching layer (Redis, CDN)
- [ ] Async processing for heavy tasks
- [ ] Rate limiting and circuit breakers
Examples
Input: "Design a notification system" Action: Define channels, queue architecture, delivery guarantees, scaling strategy
Input: "Should we use microservices?" Action: Analyze team size, complexity, scaling needs, recommend with trade-offs
Related Skills
htlin222/zettel
testing
VerifiedTrustedCommunity
Converts narrative medical text into Pocket Medicine bullet-style notes with proper abbreviations, then modularizes sections exceeding 20 lines into linked standalone files.
76SKILL.mdUpdated Apr 5, 2026
htlin222/vm-docker
devops
VerifiedTrustedCommunity
Use when deploying Docker services on the local VM (hostname: vm, Pop!_OS) with Traefik reverse proxy and Homepage dashboard. Covers crane image workflow, Traefik file-provider registration, Homepage services.yaml entries, and compose templates on the traefik-proxy network.
76SKILL.mdUpdated Apr 5, 2026
htlin222/visualization-check
development
VerifiedTrustedCommunity
Use when reviewing a data visualization or figure for clarity, checking if a graph communicates its message without additional context, or iterating on R/Python plot scripts until a naive reader can fully understand the figure.
76SKILL.mdUpdated Apr 5, 2026
htlin222/vale
development
VerifiedTrustedCommunity
Runs Vale prose linter on markdown/text files and auto-fixes issues. Use when the user asks to lint, proofread, or improve writing quality of markdown or text files.
76SKILL.mdUpdated Apr 5, 2026