rkmahale17/rulcode.com / .agents/skills/system-design-guides
System Design Guides
VerifiedSkill for adding or updating system design guides tailored for college students and beginners, using simple analogies and no simulations.
System Design Guides Skill
This skill is invoked when creating or updating educational system design guides (e.g., "Introduction to System Design", "Load Balancing", "Databases") in the system-design section.
Workflow Process
1. Identify and Structure
- Ensure the guide data file is created in
src/data/guides/and exposes acontentmarkdown string. - Register the new guide in
src/data/guidesData.tsunder thesystem-designcategory. - Verify that
system-designis included in the guide groups insrc/config/sidebarNav.tsso it appears in the sidebar navigation.
2. Implementation Rules & Standards
When writing the content for the system design guide, rigidly follow these rules:
- Target Audience (College Students): The language must be accessible, engaging, and devoid of overly dense academic jargon. Write for a college student who knows basic programming but is new to large-scale infrastructure.
- Proper Analogies: Always start complex topics with a relatable, real-world analogy. For example:
- Load Balancer: A host at a restaurant directing guests to different tables so no single waiter is overwhelmed.
- Cache: Keeping your most-used books on your desk instead of walking to the library.
- Message Queues: A post office holding letters until the mail carrier is ready to deliver them.
- Core Architecture Components: Introduce system design by focusing on essential building blocks: Load Balancers, Caching, Databases (SQL vs NoSQL), Message Queues, Blob Storage, and CDNs.
- Fundamental Principles & Trade-offs: Always explain the "Why" behind a choice, not just the "What". Discuss Scalability (Vertical vs. Horizontal), Statelessness, Data Partitioning, and CAP Theorem trade-offs (e.g., Consistency vs. Availability).
- No Simulation Visualizations: Do not include any interactive simulation visualizations (
viz:links). The system design pages rely entirely on static markdown, rich text formatting, and images. - Images with Zoom Modal: Use standard markdown images
. The markdown renderer is configured to automatically display these images with an interactive click-to-zoom modal (Dialog) for better readability of complex architectural diagrams. - Engaging Formatting: Use GitHub-flavored alerts (
> [!NOTE],> [!IMPORTANT], etc.), clear headings, bullet points, and tables to structure the information logically.
3. Verification
- Verify that
guidesData.tshas been correctly updated with the new content. - Ensure the markdown content renders correctly, particularly the image zoom modal.
- Verify that the language is appropriate for students and uses effective analogies.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |