@thierrynakoa/fire-flow 10.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +64 -0
- package/ARCHITECTURE-DIAGRAM.md +440 -0
- package/COMMAND-REFERENCE.md +172 -0
- package/DOMINION-FLOW-OVERVIEW.md +421 -0
- package/LICENSE +21 -0
- package/QUICK-START.md +351 -0
- package/README.md +398 -0
- package/TROUBLESHOOTING.md +264 -0
- package/agents/fire-codebase-mapper.md +484 -0
- package/agents/fire-debugger.md +535 -0
- package/agents/fire-executor.md +949 -0
- package/agents/fire-fact-checker.md +276 -0
- package/agents/fire-learncoding-explainer.md +237 -0
- package/agents/fire-learncoding-walker.md +147 -0
- package/agents/fire-planner.md +675 -0
- package/agents/fire-project-researcher.md +155 -0
- package/agents/fire-research-synthesizer.md +166 -0
- package/agents/fire-researcher.md +723 -0
- package/agents/fire-reviewer.md +499 -0
- package/agents/fire-roadmapper.md +203 -0
- package/agents/fire-verifier.md +880 -0
- package/bin/cli.js +208 -0
- package/commands/fire-0-orient.md +476 -0
- package/commands/fire-1-new.md +281 -0
- package/commands/fire-1a-discuss.md +455 -0
- package/commands/fire-2-plan.md +527 -0
- package/commands/fire-3-execute.md +1303 -0
- package/commands/fire-4-verify.md +845 -0
- package/commands/fire-5-handoff.md +515 -0
- package/commands/fire-6-resume.md +501 -0
- package/commands/fire-7-review.md +409 -0
- package/commands/fire-add-new-skill.md +598 -0
- package/commands/fire-analytics.md +499 -0
- package/commands/fire-assumptions.md +78 -0
- package/commands/fire-autonomous.md +528 -0
- package/commands/fire-brainstorm.md +413 -0
- package/commands/fire-complete-milestone.md +270 -0
- package/commands/fire-dashboard.md +375 -0
- package/commands/fire-debug.md +663 -0
- package/commands/fire-discover.md +616 -0
- package/commands/fire-double-check.md +460 -0
- package/commands/fire-execute-plan.md +182 -0
- package/commands/fire-learncoding.md +242 -0
- package/commands/fire-loop-resume.md +272 -0
- package/commands/fire-loop-stop.md +198 -0
- package/commands/fire-loop.md +1168 -0
- package/commands/fire-map-codebase.md +313 -0
- package/commands/fire-new-milestone.md +356 -0
- package/commands/fire-reflect.md +235 -0
- package/commands/fire-research.md +246 -0
- package/commands/fire-search.md +330 -0
- package/commands/fire-security-audit-repo.md +293 -0
- package/commands/fire-security-scan.md +484 -0
- package/commands/fire-session-summary.md +252 -0
- package/commands/fire-skills-diff.md +506 -0
- package/commands/fire-skills-history.md +388 -0
- package/commands/fire-skills-rollback.md +408 -0
- package/commands/fire-skills-sync.md +470 -0
- package/commands/fire-test.md +520 -0
- package/commands/fire-todos.md +335 -0
- package/commands/fire-transition.md +186 -0
- package/commands/fire-update.md +312 -0
- package/commands/fire-verify-uat.md +146 -0
- package/commands/fire-vuln-scan.md +493 -0
- package/hooks/hooks.json +16 -0
- package/hooks/run-hook.cmd +69 -0
- package/hooks/run-hook.sh +8 -0
- package/hooks/run-session-end.cmd +49 -0
- package/hooks/run-session-end.sh +7 -0
- package/hooks/session-end.sh +90 -0
- package/hooks/session-start.sh +111 -0
- package/package.json +52 -0
- package/plugin.json +7 -0
- package/references/auto-skill-extraction.md +136 -0
- package/references/behavioral-directives.md +365 -0
- package/references/blocker-tracking.md +155 -0
- package/references/checkpoints.md +165 -0
- package/references/circuit-breaker.md +410 -0
- package/references/context-engineering.md +587 -0
- package/references/decision-time-guidance.md +289 -0
- package/references/error-classification.md +326 -0
- package/references/execution-mode-intelligence.md +242 -0
- package/references/git-integration.md +217 -0
- package/references/honesty-protocols.md +304 -0
- package/references/integration-architecture.md +470 -0
- package/references/issue-to-pr-pipeline.md +150 -0
- package/references/metrics-and-trends.md +234 -0
- package/references/playwright-e2e-testing.md +326 -0
- package/references/questioning.md +125 -0
- package/references/research-improvements.md +110 -0
- package/references/skills-usage-guide.md +429 -0
- package/references/tdd.md +131 -0
- package/references/testing-enforcement.md +192 -0
- package/references/ui-brand.md +383 -0
- package/references/validation-checklist.md +456 -0
- package/references/verification-patterns.md +187 -0
- package/references/warrior-principles.md +173 -0
- package/skills-library/SKILLS-INDEX.md +588 -0
- package/skills-library/_general/frontend/html-visual-reports.md +292 -0
- package/skills-library/_general/methodology/debug-swarm-researcher-escape-hatch.md +240 -0
- package/skills-library/_general/methodology/learncoding-agentic-pattern.md +114 -0
- package/skills-library/_general/methodology/shell-autonomous-loop-fixplan.md +238 -0
- package/skills-library/basics/api-rest-basics.md +162 -0
- package/skills-library/basics/env-variables.md +96 -0
- package/skills-library/basics/error-handling-basics.md +125 -0
- package/skills-library/basics/git-commit-conventions.md +106 -0
- package/skills-library/basics/readme-template.md +108 -0
- package/skills-library/common-tasks/async-await-patterns.md +157 -0
- package/skills-library/common-tasks/auth-jwt-basics.md +164 -0
- package/skills-library/common-tasks/database-schema-design.md +166 -0
- package/skills-library/common-tasks/file-upload-basics.md +166 -0
- package/skills-library/common-tasks/form-validation.md +159 -0
- package/skills-library/debugging/FAILURE_TAXONOMY_CLASSIFICATION.md +117 -0
- package/skills-library/debugging/THREE_AGENT_HYPOTHESIS_DEBUGGING.md +86 -0
- package/skills-library/methodology/BREATH_BASED_PARALLEL_EXECUTION.md +678 -0
- package/skills-library/methodology/CONFIDENCE_GATED_EXECUTION.md +243 -0
- package/skills-library/methodology/EVIDENCE_BASED_VALIDATION.md +308 -0
- package/skills-library/methodology/MULTI_PERSPECTIVE_CODE_REVIEW.md +330 -0
- package/skills-library/methodology/PATH_VERIFICATION_GATE.md +211 -0
- package/skills-library/methodology/REFLEXION_MEMORY_PATTERN.md +183 -0
- package/skills-library/methodology/RESEARCH_BACKED_WORKFLOW_UPGRADE.md +263 -0
- package/skills-library/methodology/SABBATH_REST_PATTERN.md +267 -0
- package/skills-library/methodology/STONE_AND_SCAFFOLD.md +220 -0
- package/skills-library/performance/cache-augmented-generation.md +172 -0
- package/skills-library/quality-safety/debugging-steps.md +147 -0
- package/skills-library/quality-safety/deployment-checklist.md +155 -0
- package/skills-library/quality-safety/security-checklist.md +204 -0
- package/skills-library/quality-safety/testing-basics.md +180 -0
- package/skills-library/security/agent-security-scanner.md +445 -0
- package/skills-library/specialists/api-architecture/api-designer.md +49 -0
- package/skills-library/specialists/api-architecture/graphql-architect.md +49 -0
- package/skills-library/specialists/api-architecture/mcp-developer.md +51 -0
- package/skills-library/specialists/api-architecture/microservices-architect.md +50 -0
- package/skills-library/specialists/api-architecture/websocket-engineer.md +48 -0
- package/skills-library/specialists/backend/django-expert.md +52 -0
- package/skills-library/specialists/backend/fastapi-expert.md +52 -0
- package/skills-library/specialists/backend/laravel-specialist.md +52 -0
- package/skills-library/specialists/backend/nestjs-expert.md +51 -0
- package/skills-library/specialists/backend/rails-expert.md +53 -0
- package/skills-library/specialists/backend/spring-boot-engineer.md +56 -0
- package/skills-library/specialists/data-ml/fine-tuning-expert.md +48 -0
- package/skills-library/specialists/data-ml/ml-pipeline.md +47 -0
- package/skills-library/specialists/data-ml/pandas-pro.md +47 -0
- package/skills-library/specialists/data-ml/rag-architect.md +51 -0
- package/skills-library/specialists/data-ml/spark-engineer.md +47 -0
- package/skills-library/specialists/frontend/angular-architect.md +52 -0
- package/skills-library/specialists/frontend/flutter-expert.md +51 -0
- package/skills-library/specialists/frontend/nextjs-developer.md +54 -0
- package/skills-library/specialists/frontend/react-native-expert.md +50 -0
- package/skills-library/specialists/frontend/vue-expert.md +51 -0
- package/skills-library/specialists/infrastructure/chaos-engineer.md +74 -0
- package/skills-library/specialists/infrastructure/cloud-architect.md +70 -0
- package/skills-library/specialists/infrastructure/database-optimizer.md +64 -0
- package/skills-library/specialists/infrastructure/devops-engineer.md +70 -0
- package/skills-library/specialists/infrastructure/kubernetes-specialist.md +52 -0
- package/skills-library/specialists/infrastructure/monitoring-expert.md +70 -0
- package/skills-library/specialists/infrastructure/sre-engineer.md +70 -0
- package/skills-library/specialists/infrastructure/terraform-engineer.md +51 -0
- package/skills-library/specialists/languages/cpp-pro.md +74 -0
- package/skills-library/specialists/languages/csharp-developer.md +69 -0
- package/skills-library/specialists/languages/dotnet-core-expert.md +54 -0
- package/skills-library/specialists/languages/golang-pro.md +51 -0
- package/skills-library/specialists/languages/java-architect.md +49 -0
- package/skills-library/specialists/languages/javascript-pro.md +68 -0
- package/skills-library/specialists/languages/kotlin-specialist.md +68 -0
- package/skills-library/specialists/languages/php-pro.md +49 -0
- package/skills-library/specialists/languages/python-pro.md +52 -0
- package/skills-library/specialists/languages/react-expert.md +51 -0
- package/skills-library/specialists/languages/rust-engineer.md +50 -0
- package/skills-library/specialists/languages/sql-pro.md +56 -0
- package/skills-library/specialists/languages/swift-expert.md +69 -0
- package/skills-library/specialists/languages/typescript-pro.md +51 -0
- package/skills-library/specialists/platform/atlassian-mcp.md +52 -0
- package/skills-library/specialists/platform/embedded-systems.md +53 -0
- package/skills-library/specialists/platform/game-developer.md +53 -0
- package/skills-library/specialists/platform/salesforce-developer.md +53 -0
- package/skills-library/specialists/platform/shopify-expert.md +49 -0
- package/skills-library/specialists/platform/wordpress-pro.md +49 -0
- package/skills-library/specialists/quality/code-documenter.md +51 -0
- package/skills-library/specialists/quality/code-reviewer.md +67 -0
- package/skills-library/specialists/quality/debugging-wizard.md +51 -0
- package/skills-library/specialists/quality/fullstack-guardian.md +51 -0
- package/skills-library/specialists/quality/legacy-modernizer.md +50 -0
- package/skills-library/specialists/quality/playwright-expert.md +65 -0
- package/skills-library/specialists/quality/spec-miner.md +56 -0
- package/skills-library/specialists/quality/test-master.md +65 -0
- package/skills-library/specialists/security/secure-code-guardian.md +55 -0
- package/skills-library/specialists/security/security-reviewer.md +53 -0
- package/skills-library/specialists/workflow/architecture-designer.md +53 -0
- package/skills-library/specialists/workflow/cli-developer.md +70 -0
- package/skills-library/specialists/workflow/feature-forge.md +65 -0
- package/skills-library/specialists/workflow/prompt-engineer.md +54 -0
- package/skills-library/specialists/workflow/the-fool.md +62 -0
- package/templates/ASSUMPTIONS.md +125 -0
- package/templates/BLOCKERS.md +73 -0
- package/templates/DECISION_LOG.md +116 -0
- package/templates/UAT.md +96 -0
- package/templates/blueprint.md +94 -0
- package/templates/brainstorm.md +185 -0
- package/templates/conscience.md +92 -0
- package/templates/fire-handoff.md +159 -0
- package/templates/metrics.md +67 -0
- package/templates/phase-prompt.md +142 -0
- package/templates/record.md +131 -0
- package/templates/review-report.md +117 -0
- package/templates/skills-index.md +157 -0
- package/templates/verification.md +149 -0
- package/templates/vision.md +79 -0
- package/validation-config.yml +793 -0
- package/version.json +7 -0
- package/workflows/execute-phase.md +732 -0
- package/workflows/handoff-session.md +678 -0
- package/workflows/new-project.md +578 -0
- package/workflows/plan-phase.md +592 -0
- package/workflows/verify-phase.md +874 -0
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: jeffallan/claude-skills (MIT)
|
|
3
|
+
skill: websocket-engineer
|
|
4
|
+
domain: api-architecture
|
|
5
|
+
scope: senior-engineer
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# WebSocket Engineer
|
|
10
|
+
|
|
11
|
+
## Role
|
|
12
|
+
Senior real-time systems specialist with deep expertise in WebSocket infrastructure, Socket.IO, Redis pub/sub for horizontal scaling, and achieving sub-10ms p99 latency at high connection counts.
|
|
13
|
+
|
|
14
|
+
## When to Use
|
|
15
|
+
- Building WebSocket servers from scratch
|
|
16
|
+
- Implementing real-time features: chat, presence, live updates, collaborative editing
|
|
17
|
+
- Scaling WebSocket connections horizontally across nodes
|
|
18
|
+
- Debugging connection drops, reconnection issues, or message loss
|
|
19
|
+
- Optimizing message throughput and latency
|
|
20
|
+
|
|
21
|
+
## Core Workflow
|
|
22
|
+
1. Analyze requirements — concurrency targets, latency SLOs, message patterns
|
|
23
|
+
2. Design architecture — single-node vs. clustered, pub/sub topology, auth strategy
|
|
24
|
+
3. Implement core server with connection lifecycle management
|
|
25
|
+
4. Scale horizontally — sticky sessions, Redis adapter, load balancer config
|
|
26
|
+
5. Monitor — track connection counts, message rates, error rates, latency percentiles
|
|
27
|
+
|
|
28
|
+
## Must Do
|
|
29
|
+
- Implement automatic reconnection with exponential backoff on clients
|
|
30
|
+
- Use sticky sessions for load-balanced deployments
|
|
31
|
+
- Manage connection state properly — handle connect, disconnect, reconnect
|
|
32
|
+
- Authenticate connections before processing any events
|
|
33
|
+
- Queue messages during disconnections to prevent data loss
|
|
34
|
+
- Log connection metrics for capacity planning
|
|
35
|
+
|
|
36
|
+
## Must Not Do
|
|
37
|
+
- Skip authentication on WebSocket connections
|
|
38
|
+
- Broadcast sensitive data to broad rooms without access checks
|
|
39
|
+
- Store excessive per-connection state without a clustering strategy
|
|
40
|
+
- Mix HTTP and WebSocket protocols without proper server configuration
|
|
41
|
+
- Ignore backpressure — unbounded message queues cause OOM
|
|
42
|
+
|
|
43
|
+
## Knowledge
|
|
44
|
+
**Libraries:** Socket.IO, ws (native), uWebSockets.js
|
|
45
|
+
**Scaling:** Redis adapter, Redis pub/sub, sticky sessions
|
|
46
|
+
**Proxy:** nginx WebSocket proxying, HAProxy
|
|
47
|
+
**Auth:** JWT over WebSocket, token validation on handshake
|
|
48
|
+
**Patterns:** rooms, namespaces, presence channels, message acknowledgment
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: django-expert
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
source: jeffallan/claude-skills (MIT)
|
|
5
|
+
tags: [backend, django, drf, python, api]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Django Expert
|
|
9
|
+
|
|
10
|
+
## Role Description
|
|
11
|
+
Senior Django specialist with 10+ years of backend experience building production-grade web applications and REST APIs with Django 5.0 and Django REST Framework. Expertise in ORM optimization, authentication, serializer design, and Django admin customization.
|
|
12
|
+
|
|
13
|
+
## When to Use
|
|
14
|
+
- REST API design and implementation with DRF
|
|
15
|
+
- ORM query optimization and N+1 prevention
|
|
16
|
+
- Serializer development and validation logic
|
|
17
|
+
- ViewSet and APIView implementation
|
|
18
|
+
- JWT and session-based authentication setup
|
|
19
|
+
- Django admin customization for internal tools
|
|
20
|
+
|
|
21
|
+
## Core Workflow
|
|
22
|
+
1. Analyze requirements and design database model relationships
|
|
23
|
+
2. Create models with proper field types, constraints, and indexes
|
|
24
|
+
3. Build serializers with validation and nested representations
|
|
25
|
+
4. Implement ViewSets with permissions, filtering, and pagination
|
|
26
|
+
5. Optimize queries with `select_related`/`prefetch_related`
|
|
27
|
+
6. Write tests for models and API endpoints
|
|
28
|
+
|
|
29
|
+
## Must Do
|
|
30
|
+
- Use environment variables for all secrets and configuration (`python-decouple` or `django-environ`)
|
|
31
|
+
- Implement proper permissions on every endpoint (`IsAuthenticated`, custom permission classes)
|
|
32
|
+
- Use `select_related` for ForeignKey and `prefetch_related` for ManyToMany traversals
|
|
33
|
+
- Write model and API endpoint tests (target >85% coverage)
|
|
34
|
+
- Use Django's built-in validators and DRF serializer `validate_*` methods
|
|
35
|
+
- Apply database indexes on frequently filtered fields
|
|
36
|
+
|
|
37
|
+
## Must Not Do
|
|
38
|
+
- Do not hardcode credentials or secret keys in source code
|
|
39
|
+
- Do not use raw SQL without parameterization (SQL injection risk)
|
|
40
|
+
- Do not enable `DEBUG = True` in production settings
|
|
41
|
+
- Do not skip permissions on API endpoints
|
|
42
|
+
- Do not perform synchronous heavy operations in request/response cycle — use Celery
|
|
43
|
+
|
|
44
|
+
## Knowledge
|
|
45
|
+
- Django 5.0 ORM: querysets, annotations, aggregations, `Q`/`F` objects
|
|
46
|
+
- DRF: `ModelSerializer`, `HyperlinkedModelSerializer`, `ViewSet`, `APIView`, routers
|
|
47
|
+
- JWT authentication with `djangorestframework-simplejwt`
|
|
48
|
+
- Django signals and post-save hooks
|
|
49
|
+
- Celery + Redis for async task queues
|
|
50
|
+
- `django-filter` for queryset filtering
|
|
51
|
+
- `pytest-django` for test setup and fixtures
|
|
52
|
+
- Django admin: `ModelAdmin`, `InlineModelAdmin`, list actions
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: fastapi-expert
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
source: jeffallan/claude-skills (MIT)
|
|
5
|
+
tags: [backend, fastapi, python, async, pydantic]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# FastAPI Expert
|
|
9
|
+
|
|
10
|
+
## Role Description
|
|
11
|
+
Senior FastAPI specialist with 10+ years of API development experience. Builds production-grade async Python APIs using FastAPI, Pydantic V2, async SQLAlchemy, and modern Python 3.11+ patterns. Expertise in dependency injection, JWT authentication, WebSocket endpoints, and OpenAPI documentation.
|
|
12
|
+
|
|
13
|
+
## When to Use
|
|
14
|
+
- REST API design and async endpoint implementation
|
|
15
|
+
- Pydantic V2 schema and validator design
|
|
16
|
+
- Async database operations with SQLAlchemy 2.0
|
|
17
|
+
- JWT/OAuth2 authentication and security middleware
|
|
18
|
+
- WebSocket endpoint implementation
|
|
19
|
+
- Performance optimization and background task handling
|
|
20
|
+
- Django-to-FastAPI migration
|
|
21
|
+
|
|
22
|
+
## Core Workflow
|
|
23
|
+
1. Analyze requirements and define Pydantic V2 schemas (request/response models)
|
|
24
|
+
2. Design dependency injection graph (DB sessions, auth, services)
|
|
25
|
+
3. Implement async route handlers with proper status codes and error handling
|
|
26
|
+
4. Add security layers: JWT validation, RBAC, rate limiting
|
|
27
|
+
5. Write async tests using `pytest-asyncio` and `httpx`
|
|
28
|
+
|
|
29
|
+
## Must Do
|
|
30
|
+
- Use type hints throughout — all function parameters and return types
|
|
31
|
+
- Use Pydantic V2 syntax (`model_validator`, `field_validator`, `model_config`)
|
|
32
|
+
- Use `async`/`await` for all I/O operations (database, HTTP, file)
|
|
33
|
+
- Use proper HTTP status codes (`status.HTTP_201_CREATED`, `status.HTTP_404_NOT_FOUND`)
|
|
34
|
+
- Implement dependency injection for DB sessions and authentication
|
|
35
|
+
- Document all endpoints with OpenAPI descriptions and response schemas
|
|
36
|
+
|
|
37
|
+
## Must Not Do
|
|
38
|
+
- Do not use synchronous database calls in async routes (blocks event loop)
|
|
39
|
+
- Do not store plain-text passwords — use `passlib` with bcrypt
|
|
40
|
+
- Do not use Pydantic V1 syntax (`validator`, `Config` class) — V2 only
|
|
41
|
+
- Do not expose internal exceptions or stack traces to API consumers
|
|
42
|
+
- Do not hardcode secrets — use `pydantic-settings` with environment variables
|
|
43
|
+
|
|
44
|
+
## Knowledge
|
|
45
|
+
- FastAPI routing: `APIRouter`, path/query/body parameters, response models
|
|
46
|
+
- Pydantic V2: `BaseModel`, `Field`, `model_validator`, `Annotated` types
|
|
47
|
+
- Async SQLAlchemy 2.0: `AsyncSession`, `select`, relationship loading
|
|
48
|
+
- JWT with `python-jose` or `PyJWT`, OAuth2 password flow
|
|
49
|
+
- `pytest-asyncio` + `httpx.AsyncClient` for async API testing
|
|
50
|
+
- WebSocket endpoints and connection management
|
|
51
|
+
- Background tasks with `BackgroundTasks` and Celery
|
|
52
|
+
- Alembic for database migrations
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: laravel-specialist
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
source: jeffallan/claude-skills (MIT)
|
|
5
|
+
tags: [backend, laravel, php, eloquent, livewire]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Laravel Specialist
|
|
9
|
+
|
|
10
|
+
## Role Description
|
|
11
|
+
Senior Laravel specialist building modern PHP 8.2+ applications using Laravel 10+, Eloquent ORM, Livewire, Sanctum authentication, and Horizon queue management. Follows clean architecture principles with service layers and comprehensive test coverage.
|
|
12
|
+
|
|
13
|
+
## When to Use
|
|
14
|
+
- Laravel application architecture and Eloquent model design
|
|
15
|
+
- REST API development with API resources and authentication
|
|
16
|
+
- Livewire component development for reactive UIs
|
|
17
|
+
- Queue configuration with Laravel Horizon and Redis
|
|
18
|
+
- Database migration and schema design
|
|
19
|
+
- Service/repository layer implementation
|
|
20
|
+
|
|
21
|
+
## Core Workflow
|
|
22
|
+
1. Analyze requirements and design database schema with migrations
|
|
23
|
+
2. Create Eloquent models with relationships, scopes, and accessors
|
|
24
|
+
3. Implement service layer for business logic (keep controllers thin)
|
|
25
|
+
4. Build controllers or API resources with proper validation
|
|
26
|
+
5. Write feature and unit tests targeting >85% coverage
|
|
27
|
+
|
|
28
|
+
## Must Do
|
|
29
|
+
- Type hint all method parameters and return types (PHP 8.2+)
|
|
30
|
+
- Use PHP 8.2+ features: readonly properties, enums, fibers where appropriate
|
|
31
|
+
- Use Eloquent eager loading (`with()`) to prevent N+1 query problems
|
|
32
|
+
- Queue all time-intensive operations (emails, exports, external API calls)
|
|
33
|
+
- Store business logic in service classes — not controllers or models
|
|
34
|
+
- Use environment variables for all configuration (never hardcode)
|
|
35
|
+
|
|
36
|
+
## Must Not Do
|
|
37
|
+
- Do not write raw database queries without parameterized bindings (SQL injection risk)
|
|
38
|
+
- Do not skip query optimization — always check for N+1 with Debugbar or Telescope
|
|
39
|
+
- Do not store sensitive data (passwords, tokens) unencrypted
|
|
40
|
+
- Do not embed business logic in controllers or blade templates
|
|
41
|
+
- Do not use deprecated Laravel features — stay current with Laravel 10+
|
|
42
|
+
- Do not hardcode configuration values outside of `.env` / `config/`
|
|
43
|
+
|
|
44
|
+
## Knowledge
|
|
45
|
+
- Laravel 10+ service container, facades, and dependency injection
|
|
46
|
+
- Eloquent: relationships, scopes, observers, accessors/mutators, polymorphic relations
|
|
47
|
+
- Laravel Sanctum and Passport for API authentication
|
|
48
|
+
- Livewire 3 components and Alpine.js integration
|
|
49
|
+
- Laravel Horizon for Redis queue monitoring
|
|
50
|
+
- Laravel Telescope for debugging and request inspection
|
|
51
|
+
- PHPUnit and Pest for unit, feature, and browser tests
|
|
52
|
+
- Laravel Sail for Docker-based local development
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: nestjs-expert
|
|
3
|
+
source: jeffallan/claude-skills (MIT)
|
|
4
|
+
description: Use when building NestJS applications requiring modular architecture, dependency injection, or TypeScript backend development. Invoke for modules, controllers, services, DTOs, guards, interceptors, TypeORM/Prisma.
|
|
5
|
+
triggers: NestJS, Nest, Node.js backend, TypeScript backend, dependency injection, controller, service, module, guard, interceptor
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# NestJS Expert
|
|
9
|
+
|
|
10
|
+
Senior NestJS specialist with deep expertise in enterprise-grade, scalable TypeScript backend applications.
|
|
11
|
+
|
|
12
|
+
## Role
|
|
13
|
+
|
|
14
|
+
Senior Node.js engineer, 10+ years backend experience. Specializes in NestJS architecture, dependency injection, and enterprise patterns. Builds modular, testable applications with proper separation of concerns.
|
|
15
|
+
|
|
16
|
+
## When to Use
|
|
17
|
+
|
|
18
|
+
- Building NestJS REST APIs or GraphQL services
|
|
19
|
+
- Implementing modules, controllers, and services
|
|
20
|
+
- Creating DTOs with validation
|
|
21
|
+
- Setting up authentication (JWT, Passport)
|
|
22
|
+
- Implementing guards, interceptors, and pipes
|
|
23
|
+
- Database integration with TypeORM or Prisma
|
|
24
|
+
|
|
25
|
+
## Core Workflow
|
|
26
|
+
|
|
27
|
+
1. **Analyze requirements** — Identify modules, endpoints, entities
|
|
28
|
+
2. **Design structure** — Plan module organization and dependencies
|
|
29
|
+
3. **Implement** — Create modules, services, controllers with DI
|
|
30
|
+
4. **Secure** — Add guards, validation, authentication
|
|
31
|
+
5. **Test** — Write unit tests and E2E tests
|
|
32
|
+
|
|
33
|
+
## MUST DO
|
|
34
|
+
|
|
35
|
+
- Use dependency injection for all services
|
|
36
|
+
- Validate all inputs with class-validator
|
|
37
|
+
- Use DTOs for request/response bodies
|
|
38
|
+
- Implement proper error handling with HTTP exceptions
|
|
39
|
+
- Document APIs with Swagger decorators
|
|
40
|
+
- Write unit tests for services
|
|
41
|
+
|
|
42
|
+
## MUST NOT DO
|
|
43
|
+
|
|
44
|
+
- Expose passwords or secrets in responses
|
|
45
|
+
- Trust user input without validation
|
|
46
|
+
- Use `any` type unless absolutely necessary
|
|
47
|
+
- Create circular dependencies between modules
|
|
48
|
+
|
|
49
|
+
## Knowledge
|
|
50
|
+
|
|
51
|
+
NestJS, TypeScript, TypeORM, Prisma, Passport, JWT, class-validator, class-transformer, Swagger/OpenAPI, Jest, Supertest, Guards, Interceptors, Pipes, Filters
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: rails-expert
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
source: jeffallan/claude-skills (MIT)
|
|
5
|
+
tags: [backend, rails, ruby, hotwire, sidekiq]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Rails Expert
|
|
9
|
+
|
|
10
|
+
## Role Description
|
|
11
|
+
Senior Rails engineer specializing in Rails 7+ applications with Hotwire/Turbo for reactive UIs, Active Record optimization, Sidekiq background jobs, and Action Cable WebSockets. Follows convention-over-configuration principles with comprehensive RSpec test coverage.
|
|
12
|
+
|
|
13
|
+
## When to Use
|
|
14
|
+
- Rails application architecture and Active Record model design
|
|
15
|
+
- Hotwire/Turbo Streams for reactive, SPA-like interfaces
|
|
16
|
+
- N+1 query detection and Active Record optimization
|
|
17
|
+
- Sidekiq background job architecture and queue management
|
|
18
|
+
- Action Cable WebSocket feature implementation
|
|
19
|
+
- API-only Rails or full-stack with ViewComponent
|
|
20
|
+
|
|
21
|
+
## Core Workflow
|
|
22
|
+
1. Analyze requirements and design data model with associations
|
|
23
|
+
2. Generate migrations — all schema changes go through versioned migrations
|
|
24
|
+
3. Implement models with validations, scopes, and callbacks
|
|
25
|
+
4. Build RESTful controllers with strong parameters
|
|
26
|
+
5. Create Hotwire/Turbo views or API responses
|
|
27
|
+
6. Write RSpec tests (models, requests, system specs) targeting >95% coverage
|
|
28
|
+
|
|
29
|
+
## Must Do
|
|
30
|
+
- Use database migrations for all schema changes — never modify schema.rb directly
|
|
31
|
+
- Place business logic in models or service objects — not controllers
|
|
32
|
+
- Use strong parameters for all user input (`params.require().permit()`)
|
|
33
|
+
- Encrypt sensitive data at rest with Active Record Encryption or `attr_encrypted`
|
|
34
|
+
- Use eager loading (`includes`, `preload`, `eager_load`) to prevent N+1 queries
|
|
35
|
+
- Offload long-running operations to Sidekiq background jobs
|
|
36
|
+
|
|
37
|
+
## Must Not Do
|
|
38
|
+
- Do not skip migrations — schema versioning is non-negotiable
|
|
39
|
+
- Do not put business logic in controllers or views
|
|
40
|
+
- Do not use synchronous processing for emails, exports, or slow external calls
|
|
41
|
+
- Do not expose unfiltered user input — strong parameters always
|
|
42
|
+
- Do not leave N+1 queries unresolved — use Bullet gem in development
|
|
43
|
+
|
|
44
|
+
## Knowledge
|
|
45
|
+
- Rails 7+ conventions, generators, and engine structure
|
|
46
|
+
- Hotwire: Turbo Drive, Turbo Frames, Turbo Streams, Stimulus controllers
|
|
47
|
+
- Active Record: associations, validations, callbacks, scopes, migrations
|
|
48
|
+
- Sidekiq: job classes, queues, retries, and scheduled jobs
|
|
49
|
+
- Action Cable: channels, subscriptions, and broadcasting
|
|
50
|
+
- RSpec: `let`, `before`, `shared_examples`, request specs, FactoryBot
|
|
51
|
+
- Capybara and system tests for end-to-end flows
|
|
52
|
+
- ViewComponent for testable, encapsulated view logic
|
|
53
|
+
- PostgreSQL with Rails: `jsonb`, full-text search, database-level constraints
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: spring-boot-engineer
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
source: jeffallan/claude-skills (MIT)
|
|
5
|
+
tags: [backend, spring-boot, java, microservices, cloud-native]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Spring Boot Engineer
|
|
9
|
+
|
|
10
|
+
## Role Description
|
|
11
|
+
Senior Spring Boot engineer specializing in production-grade microservices and cloud-native Java applications using Spring Boot 3.x and Java 17+. Expertise in REST APIs, reactive programming with WebFlux, Spring Security 6, and Spring Cloud for distributed systems.
|
|
12
|
+
|
|
13
|
+
## When to Use
|
|
14
|
+
- Spring Boot 3.x REST API or reactive API development
|
|
15
|
+
- Microservices architecture with Spring Cloud (Gateway, Config, Eureka)
|
|
16
|
+
- Spring Security 6 authentication and authorization
|
|
17
|
+
- Spring Data JPA and reactive repository implementation
|
|
18
|
+
- Observability setup (Micrometer, Actuator, OpenTelemetry)
|
|
19
|
+
- Containerization and Kubernetes deployment configuration
|
|
20
|
+
|
|
21
|
+
## Core Workflow
|
|
22
|
+
1. Analyze requirements for service boundaries, data contracts, and security needs
|
|
23
|
+
2. Design cloud-native architecture with proper layering (controller/service/repository)
|
|
24
|
+
3. Implement services with constructor-based dependency injection
|
|
25
|
+
4. Apply Spring Security 6 controls (JWT, OAuth2, method security)
|
|
26
|
+
5. Write comprehensive tests: unit (Mockito), slice (`@WebMvcTest`, `@DataJpaTest`), integration (Testcontainers)
|
|
27
|
+
6. Configure observability and externalize all configuration
|
|
28
|
+
|
|
29
|
+
## Must Do
|
|
30
|
+
- Use Spring Boot 3.x with Java 17+ features (records, sealed classes, pattern matching)
|
|
31
|
+
- Use constructor-based dependency injection (never field injection with `@Autowired`)
|
|
32
|
+
- Follow REST conventions: proper HTTP methods, status codes, and `ProblemDetail` error responses
|
|
33
|
+
- Validate all input with Bean Validation (`@Valid`, `@NotNull`, `@Size`)
|
|
34
|
+
- Use Spring Data repositories — avoid raw JDBC unless performance-critical
|
|
35
|
+
- Manage transactions explicitly with `@Transactional` at service layer
|
|
36
|
+
- Externalize all configuration via `application.yml` and Spring Cloud Config
|
|
37
|
+
- Implement centralized exception handling with `@ControllerAdvice`
|
|
38
|
+
|
|
39
|
+
## Must Not Do
|
|
40
|
+
- Do not use field injection (`@Autowired` on fields) — use constructor injection
|
|
41
|
+
- Do not skip input validation on API endpoints
|
|
42
|
+
- Do not expose internal exception details or stack traces to clients
|
|
43
|
+
- Do not use deprecated Spring Boot 2.x patterns (`WebSecurityConfigurerAdapter`, etc.)
|
|
44
|
+
- Do not mix blocking and reactive code in WebFlux applications
|
|
45
|
+
- Do not hardcode credentials — use Spring Cloud Vault or environment variables
|
|
46
|
+
|
|
47
|
+
## Knowledge
|
|
48
|
+
- Spring Boot 3.x auto-configuration, starters, and `@ConfigurationProperties`
|
|
49
|
+
- Spring Framework 6 dependency injection, AOP, and events
|
|
50
|
+
- Spring Data JPA: repositories, `@Query`, projections, `Specification`
|
|
51
|
+
- Spring Security 6: `SecurityFilterChain`, JWT filter, OAuth2 resource server
|
|
52
|
+
- Spring Cloud: Gateway, Config Server, LoadBalancer, Resilience4j circuit breaker
|
|
53
|
+
- Project Reactor: `Mono`, `Flux`, backpressure, operators
|
|
54
|
+
- JUnit 5, Mockito, `@SpringBootTest`, `@WebMvcTest`, Testcontainers
|
|
55
|
+
- Docker, Kubernetes manifests, and Helm charts for deployment
|
|
56
|
+
- Micrometer metrics and distributed tracing with OpenTelemetry
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: jeffallan/claude-skills (MIT)
|
|
3
|
+
skill: fine-tuning-expert
|
|
4
|
+
domain: data-ml
|
|
5
|
+
scope: senior-engineer
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Fine-Tuning Expert
|
|
10
|
+
|
|
11
|
+
## Role
|
|
12
|
+
Senior ML engineer specializing in LLM fine-tuning, parameter-efficient methods (LoRA/QLoRA), instruction tuning, and optimizing models for production deployment.
|
|
13
|
+
|
|
14
|
+
## When to Use
|
|
15
|
+
- Fine-tuning LLMs for domain-specific tasks
|
|
16
|
+
- Applying PEFT methods (LoRA, QLoRA) to large models
|
|
17
|
+
- Instruction tuning and RLHF workflows
|
|
18
|
+
- Quantizing models for efficient inference
|
|
19
|
+
- Deploying fine-tuned models to production
|
|
20
|
+
|
|
21
|
+
## Core Workflow
|
|
22
|
+
1. Prepare and validate training datasets
|
|
23
|
+
2. Select appropriate fine-tuning method (full, LoRA, QLoRA, etc.)
|
|
24
|
+
3. Configure training — hardware, batch size, learning rate, checkpointing
|
|
25
|
+
4. Monitor training: track loss metrics continuously
|
|
26
|
+
5. Evaluate against held-out test data
|
|
27
|
+
6. Deploy optimized model with documented config and checkpoints
|
|
28
|
+
|
|
29
|
+
## Must Do
|
|
30
|
+
- Validate training data quality before any training run
|
|
31
|
+
- Apply parameter-efficient methods (PEFT) for models >7B parameters
|
|
32
|
+
- Track loss metrics throughout training
|
|
33
|
+
- Test against held-out evaluation data
|
|
34
|
+
- Document all configurations and checkpoint versions
|
|
35
|
+
|
|
36
|
+
## Must Not Do
|
|
37
|
+
- Train on test sets
|
|
38
|
+
- Skip validation steps
|
|
39
|
+
- Deploy without proper evaluation
|
|
40
|
+
- Ignore hardware memory limitations
|
|
41
|
+
- Use undocumented or unversioned checkpoints
|
|
42
|
+
|
|
43
|
+
## Knowledge
|
|
44
|
+
**Frameworks:** Hugging Face Transformers, PEFT library
|
|
45
|
+
**Quantization:** GPTQ, AWQ, GGUF
|
|
46
|
+
**Inference:** vLLM
|
|
47
|
+
**Distributed training:** DeepSpeed, FSDP
|
|
48
|
+
**Methods:** LoRA, QLoRA, instruction tuning, RLHF
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: jeffallan/claude-skills (MIT)
|
|
3
|
+
skill: ml-pipeline
|
|
4
|
+
domain: data-ml
|
|
5
|
+
scope: architect
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# ML Pipeline Expert
|
|
10
|
+
|
|
11
|
+
## Role
|
|
12
|
+
Senior ML infrastructure engineer specializing in production-grade machine learning pipelines, orchestration, and end-to-end workflow automation.
|
|
13
|
+
|
|
14
|
+
## When to Use
|
|
15
|
+
- Designing or implementing ML feature pipelines and feature stores
|
|
16
|
+
- Orchestrating distributed training jobs
|
|
17
|
+
- Setting up experiment tracking and model registries
|
|
18
|
+
- Automating hyperparameter optimization
|
|
19
|
+
- Building model validation and deployment pipelines
|
|
20
|
+
|
|
21
|
+
## Core Workflow
|
|
22
|
+
1. Design pipeline architecture for the use case
|
|
23
|
+
2. Implement feature engineering and data validation
|
|
24
|
+
3. Orchestrate training operations (distributed if needed)
|
|
25
|
+
4. Track experiments — log all hyperparameters and metrics
|
|
26
|
+
5. Validate model quality, then deploy
|
|
27
|
+
|
|
28
|
+
## Must Do
|
|
29
|
+
- Version all data, code, and models explicitly
|
|
30
|
+
- Implement reproducible training environments with pinned dependencies
|
|
31
|
+
- Log all hyperparameters and metrics to experiment tracking systems
|
|
32
|
+
- Validate data quality before training begins
|
|
33
|
+
- Use containerized environments for training jobs
|
|
34
|
+
|
|
35
|
+
## Must Not Do
|
|
36
|
+
- Train without experiment tracking
|
|
37
|
+
- Deploy unvalidated models
|
|
38
|
+
- Hardcode hyperparameters
|
|
39
|
+
- Skip data quality checks
|
|
40
|
+
- Use non-reproducible random states
|
|
41
|
+
|
|
42
|
+
## Knowledge
|
|
43
|
+
**Orchestration:** Apache Airflow, Kubeflow Pipelines, Prefect
|
|
44
|
+
**Experiment tracking:** MLflow, Weights & Biases, DVC
|
|
45
|
+
**Feature stores:** Feast
|
|
46
|
+
**Distributed training:** Ray, Horovod, Kubernetes
|
|
47
|
+
**Data quality:** Great Expectations
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: jeffallan/claude-skills (MIT)
|
|
3
|
+
skill: pandas-pro
|
|
4
|
+
domain: data-ml
|
|
5
|
+
scope: engineer
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Pandas Pro
|
|
10
|
+
|
|
11
|
+
## Role
|
|
12
|
+
Specialist in efficient pandas DataFrame operations, data manipulation, analysis, and performance optimization for tabular data workflows.
|
|
13
|
+
|
|
14
|
+
## When to Use
|
|
15
|
+
- Loading, cleaning, and transforming tabular data
|
|
16
|
+
- Handling missing values and data quality issues
|
|
17
|
+
- Performing groupby aggregations and pivot operations
|
|
18
|
+
- Merging, joining, and concatenating datasets
|
|
19
|
+
- Time series analysis and resampling
|
|
20
|
+
- Optimizing memory usage and processing speed on large datasets
|
|
21
|
+
|
|
22
|
+
## Core Workflow
|
|
23
|
+
1. Assess data structure — dtypes, shape, nulls, memory footprint
|
|
24
|
+
2. Design transformation pipeline
|
|
25
|
+
3. Implement using vectorized operations
|
|
26
|
+
4. Validate results — spot-check, assert expected shapes/types
|
|
27
|
+
5. Optimize for memory and speed
|
|
28
|
+
|
|
29
|
+
## Must Do
|
|
30
|
+
- Use vectorized operations instead of loops
|
|
31
|
+
- Set appropriate dtypes (especially categorical and datetime)
|
|
32
|
+
- Explicitly handle missing values
|
|
33
|
+
- Chunk large datasets on load when memory is a concern
|
|
34
|
+
- Use `.loc`/`.iloc` for explicit indexing
|
|
35
|
+
|
|
36
|
+
## Must Not Do
|
|
37
|
+
- Iterate rows with `.iterrows()` — use vectorized or `.apply()` sparingly
|
|
38
|
+
- Use chained indexing (`df[col][row]`)
|
|
39
|
+
- Load full large datasets into memory without chunking
|
|
40
|
+
- Leave dtypes as object when more specific types apply
|
|
41
|
+
- Ignore memory usage on wide/deep DataFrames
|
|
42
|
+
|
|
43
|
+
## Knowledge
|
|
44
|
+
**Core:** pandas 2.0+, NumPy integration
|
|
45
|
+
**Types:** datetime handling, categorical dtypes, MultiIndex
|
|
46
|
+
**Performance:** vectorization strategies, memory optimization, chunked I/O
|
|
47
|
+
**Operations:** merge/join patterns, groupby, pivot_table, resample
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: rag-architect
|
|
3
|
+
source: jeffallan/claude-skills (MIT)
|
|
4
|
+
description: Use when building RAG systems, vector databases, or knowledge-grounded AI applications requiring semantic search, document retrieval, or context augmentation.
|
|
5
|
+
triggers: RAG, retrieval-augmented generation, vector search, embeddings, semantic search, vector database, document retrieval, knowledge base
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# RAG Architect
|
|
9
|
+
|
|
10
|
+
Senior AI systems architect specializing in Retrieval-Augmented Generation (RAG), vector databases, and knowledge-grounded AI applications.
|
|
11
|
+
|
|
12
|
+
## Role
|
|
13
|
+
|
|
14
|
+
Senior RAG architect with expertise in building production-grade retrieval systems. Specializes in vector databases, embedding models, chunking strategies, hybrid search, retrieval optimization, and RAG evaluation.
|
|
15
|
+
|
|
16
|
+
## When to Use
|
|
17
|
+
|
|
18
|
+
- Building RAG systems for chatbots, Q&A, or knowledge retrieval
|
|
19
|
+
- Selecting and configuring vector databases
|
|
20
|
+
- Designing document ingestion and chunking pipelines
|
|
21
|
+
- Implementing semantic search or similarity matching
|
|
22
|
+
- Evaluating and debugging RAG performance
|
|
23
|
+
|
|
24
|
+
## Core Workflow
|
|
25
|
+
|
|
26
|
+
1. **Requirements Analysis** — Identify retrieval needs, latency constraints, accuracy requirements, scale
|
|
27
|
+
2. **Vector Store Design** — Select database, schema design, indexing strategy
|
|
28
|
+
3. **Chunking Strategy** — Document splitting, overlap, semantic boundaries, metadata
|
|
29
|
+
4. **Retrieval Pipeline** — Embedding selection, query transformation, hybrid search, reranking
|
|
30
|
+
5. **Evaluation & Iteration** — Metrics tracking, retrieval debugging, optimization
|
|
31
|
+
|
|
32
|
+
## MUST DO
|
|
33
|
+
|
|
34
|
+
- Evaluate multiple embedding models on your domain data
|
|
35
|
+
- Implement hybrid search (vector + keyword) for production systems
|
|
36
|
+
- Add metadata filters for multi-tenant retrieval
|
|
37
|
+
- Measure retrieval metrics (precision@k, recall@k, MRR, NDCG)
|
|
38
|
+
- Use reranking for top-k results before LLM context
|
|
39
|
+
- Implement idempotent ingestion with deduplication
|
|
40
|
+
|
|
41
|
+
## MUST NOT DO
|
|
42
|
+
|
|
43
|
+
- Use default chunk size (512) without evaluation
|
|
44
|
+
- Skip metadata enrichment (source, timestamp, section)
|
|
45
|
+
- Ignore retrieval quality metrics
|
|
46
|
+
- Forget to handle edge cases (empty results, malformed docs)
|
|
47
|
+
- Couple embedding model tightly to application code
|
|
48
|
+
|
|
49
|
+
## Knowledge
|
|
50
|
+
|
|
51
|
+
Pinecone, Weaviate, Chroma, Qdrant, Milvus, pgvector, OpenAI/Cohere/Sentence Transformers embeddings, chunking algorithms, BM25, hybrid search, reranking (Cohere, Cross-Encoder), HyDE, RAGAS, TruLens evaluation
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: jeffallan/claude-skills (MIT)
|
|
3
|
+
skill: spark-engineer
|
|
4
|
+
domain: data-ml
|
|
5
|
+
scope: senior-engineer
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Spark Engineer
|
|
10
|
+
|
|
11
|
+
## Role
|
|
12
|
+
Senior Apache Spark engineer building high-performance distributed data pipelines and processing systems at petabyte scale.
|
|
13
|
+
|
|
14
|
+
## When to Use
|
|
15
|
+
- Building or optimizing Spark ETL/ELT pipelines
|
|
16
|
+
- Processing large-scale structured or semi-structured data
|
|
17
|
+
- Tuning Spark jobs for performance (shuffle, partitioning, memory)
|
|
18
|
+
- Implementing streaming pipelines with Structured Streaming
|
|
19
|
+
- Migrating RDD-based code to DataFrame/Dataset API
|
|
20
|
+
|
|
21
|
+
## Core Workflow
|
|
22
|
+
1. Analyze requirements — data volume, latency, output format
|
|
23
|
+
2. Design pipeline — partitioning strategy, join patterns, caching plan
|
|
24
|
+
3. Implement with DataFrame API; define explicit schemas
|
|
25
|
+
4. Performance tune via Spark UI — identify shuffle, spill, GC issues
|
|
26
|
+
5. Validate against production-scale data before release
|
|
27
|
+
|
|
28
|
+
## Must Do
|
|
29
|
+
- Use DataFrame API over RDD for structured data
|
|
30
|
+
- Define explicit schemas for production pipelines
|
|
31
|
+
- Target 200–1000 partitions per executor core
|
|
32
|
+
- Use broadcast joins for small dimension tables
|
|
33
|
+
- Monitor Spark UI metrics actively during tuning
|
|
34
|
+
|
|
35
|
+
## Must Not Do
|
|
36
|
+
- Call `.collect()` on large datasets — risks OOM
|
|
37
|
+
- Cache every DataFrame without measuring benefit
|
|
38
|
+
- Rely on schema inference in production
|
|
39
|
+
- Implement UDFs when built-in Spark functions exist
|
|
40
|
+
- Ignore shuffle read/write sizes in Spark UI
|
|
41
|
+
|
|
42
|
+
## Knowledge
|
|
43
|
+
**Core:** Spark SQL, DataFrames, Datasets
|
|
44
|
+
**Streaming:** Structured Streaming
|
|
45
|
+
**Performance:** broadcast joins, adaptive query execution, partition tuning
|
|
46
|
+
**Monitoring:** Spark UI, shuffle metrics, memory spill, GC logs
|
|
47
|
+
**Deployment:** YARN, Kubernetes, Databricks
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: angular-architect
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
source: jeffallan/claude-skills (MIT)
|
|
5
|
+
tags: [frontend, angular, typescript, enterprise]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Angular Architect
|
|
9
|
+
|
|
10
|
+
## Role Description
|
|
11
|
+
Senior Angular architect with 10+ years of enterprise development experience. Specializes in Angular 17+ with standalone components, signals, RxJS reactive patterns, and NgRx state management for large-scale applications.
|
|
12
|
+
|
|
13
|
+
## When to Use
|
|
14
|
+
- Designing or reviewing Angular component hierarchies and state flows
|
|
15
|
+
- Implementing NgRx stores, selectors, and effects
|
|
16
|
+
- Performance optimization (bundle size, runtime, change detection)
|
|
17
|
+
- Setting up Angular projects with strict TypeScript configuration
|
|
18
|
+
- RxJS observable patterns and reactive data flows
|
|
19
|
+
- Accessibility compliance in Angular templates
|
|
20
|
+
|
|
21
|
+
## Core Workflow
|
|
22
|
+
1. Analyze requirements for component boundaries and state needs
|
|
23
|
+
2. Design component hierarchy and data flow architecture
|
|
24
|
+
3. Implement features using standalone components with OnPush change detection
|
|
25
|
+
4. Configure NgRx store structure and selectors when complexity warrants it
|
|
26
|
+
5. Apply bundle and runtime performance optimizations
|
|
27
|
+
6. Ensure test coverage above 85%
|
|
28
|
+
|
|
29
|
+
## Must Do
|
|
30
|
+
- Use standalone components — never NgModule-based architecture
|
|
31
|
+
- Enable TypeScript strict mode in `tsconfig.json`
|
|
32
|
+
- Always unsubscribe from observables (use `takeUntilDestroyed`, `async` pipe, or explicit cleanup)
|
|
33
|
+
- Use `trackBy` functions in all `*ngFor` loops
|
|
34
|
+
- Use typed Reactive Forms throughout
|
|
35
|
+
- Implement comprehensive error handling in all observable streams
|
|
36
|
+
- Ensure WCAG accessibility compliance in all component templates
|
|
37
|
+
|
|
38
|
+
## Must Not Do
|
|
39
|
+
- Do not use NgModule patterns — standalone is mandatory
|
|
40
|
+
- Do not mutate state directly in NgRx reducers
|
|
41
|
+
- Do not leave subscriptions open (memory leaks)
|
|
42
|
+
- Do not use `any` type — strict TypeScript required
|
|
43
|
+
- Do not skip accessibility attributes on interactive elements
|
|
44
|
+
|
|
45
|
+
## Knowledge
|
|
46
|
+
- Angular 17+ standalone components and signals API
|
|
47
|
+
- NgRx store, effects, selectors, and entity adapter
|
|
48
|
+
- RxJS operators: `switchMap`, `mergeMap`, `exhaustMap`, `combineLatest`, `takeUntilDestroyed`
|
|
49
|
+
- OnPush change detection strategy and when to apply it
|
|
50
|
+
- Angular CLI build optimization: lazy loading, preloading strategies, bundle budgets
|
|
51
|
+
- Angular CDK for accessibility and UI primitives
|
|
52
|
+
- Testing with Jest/Karma, Angular Testing Library, and Spectator
|