Skip to content

feat(python-development): add fastapi skill with progressive disclosure #148

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Draft
kiriz wants to merge 11 commits into
base: main
Choose a base branch
from
Draft

feat(python-development): add fastapi skill with progressive disclosure #148

kiriz wants to merge 11 commits into from

Conversation

@kiriz
Copy link
Contributor

@kiriz kiriz commented Dec 20, 2025

Summary

  • Add new fastapi skill following Anthropic's progressive disclosure best practices
  • Restructure to match temporal-python-testing pattern (small SKILL.md + resources/)
  • Link fastapi-pro agent to reference the new skill

Structure

fastapi/
├── SKILL.md              # 181 lines - essentials + navigation
└── resources/
    ├── service-layer.md      # Service pattern, exceptions, settings
    ├── database-patterns.md  # SQLAlchemy 2.0, StaticPool testing
    ├── deployment.md         # Gunicorn, structlog, project structure
    └── async-patterns.md     # Library alternatives, circular imports

Key Patterns Included

  • Async Golden Rule: def for blocking, async def for truly async
  • Nested DI: db → service → route chain
  • Annotated Dependencies: Type aliases for clean signatures
  • Pydantic Validation: Model-based, not manual if-checks
  • Lifespan Events: Not deprecated @app.on_event

Test Plan

  • Verify skill triggers on "fastapi" keyword
  • Confirm resources load on demand
  • Test fastapi-pro agent references skill correctly
Kiran Eshwarappa added 11 commits December 20, 2025 04:22
docs: add excalidraw-diagram skill design document
bc86b1d 
Design for a skill that generates, corrects, and refines professional
Excalidraw diagrams for architecture documentation.

Key features:
- Three modes: Generate, Correct, Refine
- Component library from library-master.excalidrawlib (22 components)
- Pattern templates for 5 diagram types
- Configurable palettes (architecture, workflow, aws, k8s, minimal)
- Two visual styles (hand-drawn, clean)
- Technical writing rules for concise labels
- 16:9 frames for presentation-ready output
feat: add excalidraw-diagram skill for architecture diagrams
249af14 
New diagram-generation plugin with excalidraw-diagram skill that:

- Generates professional Excalidraw diagrams (system arch, workflow,
  sequence, ERD, deployment)
- Corrects existing diagrams (layout, colors, spacing)
- Refines labels using technical writing rules
- Wraps all diagrams in 16:9 frames for presentations

Includes:
- 5 color palettes (architecture, workflow, aws, k8s, minimal)
- 5 pattern templates for each diagram type
- 19 pre-built components from library-master.excalidrawlib
- Primitive shapes, connectors, and label templates
- Technical writing rules for concise, accurate labels

Based on Open Colors (Excalidraw's native palette) and uber.excalidraw
style patterns (hachure fill, roughness 1, opacity 60).
chore: register diagram-generation plugin in marketplace
d6b28e1 
Add diagram-generation plugin entry to marketplace.json to enable
installation via /plugin install command for all users.
fix: enforce Clients library component for user/actor representation
75f7a84 
- Add MANDATORY instruction in generation workflow to use Clients component
- Add Actor/User Representation section with mapping table
- Add Component Selection Priority (library > patterns > primitives)
- Add output validation rules to catch incorrect user representation
- Prevent use of plain ellipses/ovals for users, admins, customers, actors
docs(excalidraw-diagram): add uniform coloring guidelines for similar…
de608a7 
… elements

Add section documenting best practices for applying consistent colors
to elements of the same architectural category. This prevents visual
clutter and improves diagram readability when multiple similar elements
(e.g., multiple cloud providers) appear together.
feat(excalidraw-skill): add mandatory arrow connection bindings
9b99ddf 
- Add Arrow Connections (MANDATORY) section with 3-part binding requirement
- Document binding parameters: elementId, focus, gap
- Add validation checks wshobson#9 and wshobson#10 for arrow integrity
- Ensure arrows stay connected when diagram elements are moved
refactor(excalidraw-skill): condense SKILL.md and add categorized lib…
a2f0b1d 
…rary

- Reduce SKILL.md from 869 to 268 lines (under 500-line limit)
- Add maintainer note about line limit per Anthropic best practices
- Fix path discrepancies (assets/config.json, assets/palettes.json)
- Add boundary styling rule (external=transparent+dashed)
- Remove redundant components/library.json (replaced by categorized library)
- Add categorized library/ with 92 components across 20 categories
- Create reference/element-templates.md for detailed JSON templates
- Create reference/icon-generation.md for icon creation guide
- Follow progressive disclosure pattern per Anthropic guidelines
refactor(excalidraw-library): consolidate to flat category-based stru…
95d85fc 
…cture

- Consolidate 90 individual .excalidraw files into 20 category files
- Implement structured naming: {category}-{component}-{element} for IDs
- Add groupId convention: {category}-{component} for component filtering
- Update index.json to v4 with file/groupId references
- Update LIBRARY-LOADER.md with new lookup algorithms
- Add consolidate.py and transform-to-excalidraw.py utility scripts
- Remove empty category subfolders

Benefits:
- Reduces file I/O from 90 reads to max 20 per diagram
- Enables VS Code/Excalidraw preview with .excalidraw extension
- Structured IDs allow easy component identification and rearrangement
- Flat structure simplifies maintenance
docs(excalidraw-skill): update SKILL.md for flat library structure
9599262 
- Update library references from folder paths to flat category files
- Document groupId-based component filtering approach
- Update actor representation to use actors.excalidraw with groupId
- Remove one-time utility scripts (consolidate.py, transform-to-excalidraw.py)
- Remove backup file (index.json.backup)
feat(diagram-generation): add diagram-pro agent and commands
7d4e22c 
- Add diagram-pro.md agent for Excalidraw diagram generation
- Add diagram-generate.md command for creating new diagrams
- Add diagram-fix.md command for correcting existing diagrams
- Remove redundant plugin.json (marketplace.json is source of truth)
- Update marketplace.json with agents and commands refs
feat(python-development): add fastapi skill with progressive disclosure
aca0bea 
- Create fastapi skill following temporal-python-testing pattern
- SKILL.md (181 lines): essentials inline + resource navigation
- resources/service-layer.md: service pattern, exceptions, settings
- resources/database-patterns.md: SQLAlchemy 2.0, StaticPool testing
- resources/deployment.md: Gunicorn, structlog, project structure
- resources/async-patterns.md: library alternatives, circular imports
- Link fastapi-pro agent to new skill
- Register in marketplace.json
@kiriz kiriz marked this pull request as draft December 20, 2025 21:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant

@kiriz