diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 7bb0c26..c881e2c 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -20,7 +20,7 @@ body: label: Preliminary Checks description: Please confirm you have completed these steps options: - - label: I have read the [Code of Conduct](.github/CODE_OF_CONDUCT.md) + - label: I have read the [Code of Conduct](https://github.com/wshobson/agents/blob/main/.github/CODE_OF_CONDUCT.md) required: true - label: >- I have searched existing issues to ensure this is not a duplicate diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index 8410371..a5187ec 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -19,7 +19,7 @@ body: label: Preliminary Checks description: Please confirm you have completed these steps options: - - label: I have read the [Code of Conduct](.github/CODE_OF_CONDUCT.md) + - label: I have read the [Code of Conduct](https://github.com/wshobson/agents/blob/main/.github/CODE_OF_CONDUCT.md) required: true - label: >- I have searched existing issues to ensure this is not a duplicate diff --git a/.github/ISSUE_TEMPLATE/new_subagent.yml b/.github/ISSUE_TEMPLATE/new_subagent.yml index f2b0a59..3ae2998 100644 --- a/.github/ISSUE_TEMPLATE/new_subagent.yml +++ b/.github/ISSUE_TEMPLATE/new_subagent.yml @@ -20,7 +20,7 @@ body: label: Preliminary Checks description: Please confirm you have completed these steps options: - - label: I have read the [Code of Conduct](.github/CODE_OF_CONDUCT.md) + - label: I have read the [Code of Conduct](https://github.com/wshobson/agents/blob/main/.github/CODE_OF_CONDUCT.md) required: true - label: >- I have reviewed existing subagents to ensure this is not a duplicate diff --git a/plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md b/plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md index d02900d..47d2fdf 100644 --- a/plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md +++ b/plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md @@ -536,10 +536,3 @@ function logAccessibleName(element) { - **Don't test only happy path** - Test error states - **Don't skip dynamic content** - Most common issues - **Don't rely on visual testing** - Different experience - -## Resources - -- [VoiceOver User Guide](https://support.apple.com/guide/voiceover/welcome/mac) -- [NVDA User Guide](https://www.nvaccess.org/files/nvda/documentation/userGuide.html) -- [JAWS Documentation](https://support.freedomscientific.com/Products/Blindness/JAWS) -- [WebAIM Screen Reader Survey](https://webaim.org/projects/screenreadersurvey/) diff --git a/plugins/accessibility-compliance/skills/wcag-audit-patterns/SKILL.md b/plugins/accessibility-compliance/skills/wcag-audit-patterns/SKILL.md index e6d9c58..65063d4 100644 --- a/plugins/accessibility-compliance/skills/wcag-audit-patterns/SKILL.md +++ b/plugins/accessibility-compliance/skills/wcag-audit-patterns/SKILL.md @@ -546,10 +546,3 @@ class AccessibleDropdown extends HTMLElement { - **Don't hide focus outlines** - Keyboard users need them - **Don't disable zoom** - Users need to resize - **Don't use color alone** - Multiple indicators needed - -## Resources - -- [WCAG 2.2 Guidelines](https://www.w3.org/TR/WCAG22/) -- [WebAIM](https://webaim.org/) -- [A11y Project Checklist](https://www.a11yproject.com/checklist/) -- [axe DevTools](https://www.deque.com/axe/) diff --git a/plugins/api-scaffolding/skills/fastapi-templates/SKILL.md b/plugins/api-scaffolding/skills/fastapi-templates/SKILL.md index 49fc60a..5568c1f 100644 --- a/plugins/api-scaffolding/skills/fastapi-templates/SKILL.md +++ b/plugins/api-scaffolding/skills/fastapi-templates/SKILL.md @@ -538,30 +538,3 @@ async def test_create_user(client): assert data["email"] == "test@example.com" assert "id" in data ``` - -## Resources - -- **references/fastapi-architecture.md**: Detailed architecture guide -- **references/async-best-practices.md**: Async/await patterns -- **references/testing-strategies.md**: Comprehensive testing guide -- **assets/project-template/**: Complete FastAPI project -- **assets/docker-compose.yml**: Development environment setup - -## Best Practices - -1. **Async All The Way**: Use async for database, external APIs -2. **Dependency Injection**: Leverage FastAPI's DI system -3. **Repository Pattern**: Separate data access from business logic -4. **Service Layer**: Keep business logic out of routes -5. **Pydantic Schemas**: Strong typing for request/response -6. **Error Handling**: Consistent error responses -7. **Testing**: Test all layers independently - -## Common Pitfalls - -- **Blocking Code in Async**: Using synchronous database drivers -- **No Service Layer**: Business logic in route handlers -- **Missing Type Hints**: Loses FastAPI's benefits -- **Ignoring Sessions**: Not properly managing database sessions -- **No Testing**: Skipping integration tests -- **Tight Coupling**: Direct database access in routes diff --git a/plugins/backend-development/skills/api-design-principles/SKILL.md b/plugins/backend-development/skills/api-design-principles/SKILL.md index 93352bb..437cc3c 100644 --- a/plugins/backend-development/skills/api-design-principles/SKILL.md +++ b/plugins/backend-development/skills/api-design-principles/SKILL.md @@ -516,13 +516,3 @@ def create_context(): - **Poor Documentation**: Undocumented APIs frustrate developers - **Ignoring HTTP Semantics**: POST for idempotent operations breaks expectations - **Tight Coupling**: API structure shouldn't mirror database schema - -## Resources - -- **references/rest-best-practices.md**: Comprehensive REST API design guide -- **references/graphql-schema-design.md**: GraphQL schema patterns and anti-patterns -- **references/api-versioning-strategies.md**: Versioning approaches and migration paths -- **assets/rest-api-template.py**: FastAPI REST API template -- **assets/graphql-schema-template.graphql**: Complete GraphQL schema example -- **assets/api-design-checklist.md**: Pre-implementation review checklist -- **scripts/openapi-generator.py**: Generate OpenAPI specs from code diff --git a/plugins/backend-development/skills/architecture-patterns/SKILL.md b/plugins/backend-development/skills/architecture-patterns/SKILL.md index ba0a359..aa738cf 100644 --- a/plugins/backend-development/skills/architecture-patterns/SKILL.md +++ b/plugins/backend-development/skills/architecture-patterns/SKILL.md @@ -464,31 +464,3 @@ class OrderRepository: await self._publish_events(order._events) order._events.clear() ``` - -## Resources - -- **references/clean-architecture-guide.md**: Detailed layer breakdown -- **references/hexagonal-architecture-guide.md**: Ports and adapters patterns -- **references/ddd-tactical-patterns.md**: Entities, value objects, aggregates -- **assets/clean-architecture-template/**: Complete project structure -- **assets/ddd-examples/**: Domain modeling examples - -## Best Practices - -1. **Dependency Rule**: Dependencies always point inward -2. **Interface Segregation**: Small, focused interfaces -3. **Business Logic in Domain**: Keep frameworks out of core -4. **Test Independence**: Core testable without infrastructure -5. **Bounded Contexts**: Clear domain boundaries -6. **Ubiquitous Language**: Consistent terminology -7. **Thin Controllers**: Delegate to use cases -8. **Rich Domain Models**: Behavior with data - -## Common Pitfalls - -- **Anemic Domain**: Entities with only data, no behavior -- **Framework Coupling**: Business logic depends on frameworks -- **Fat Controllers**: Business logic in controllers -- **Repository Leakage**: Exposing ORM objects -- **Missing Abstractions**: Concrete dependencies in core -- **Over-Engineering**: Clean architecture for simple CRUD diff --git a/plugins/backend-development/skills/cqrs-implementation/SKILL.md b/plugins/backend-development/skills/cqrs-implementation/SKILL.md index 4104c78..efa0d7a 100644 --- a/plugins/backend-development/skills/cqrs-implementation/SKILL.md +++ b/plugins/backend-development/skills/cqrs-implementation/SKILL.md @@ -547,8 +547,3 @@ class ConsistentQueryHandler: - **Don't couple read/write schemas** - Independent evolution - **Don't over-engineer** - Start simple - **Don't ignore consistency SLAs** - Define acceptable lag - -## Resources - -- [CQRS Pattern](https://martinfowler.com/bliki/CQRS.html) -- [Microsoft CQRS Guidance](https://docs.microsoft.com/en-us/azure/architecture/patterns/cqrs) diff --git a/plugins/backend-development/skills/event-store-design/SKILL.md b/plugins/backend-development/skills/event-store-design/SKILL.md index 6c8485b..8d9700d 100644 --- a/plugins/backend-development/skills/event-store-design/SKILL.md +++ b/plugins/backend-development/skills/event-store-design/SKILL.md @@ -429,9 +429,3 @@ Capacity: On-demand or provisioned based on throughput needs - **Don't store large payloads** - Keep events small - **Don't skip optimistic concurrency** - Prevents data corruption - **Don't ignore backpressure** - Handle slow consumers - -## Resources - -- [EventStoreDB](https://www.eventstore.com/) -- [Marten Events](https://martendb.io/events/) -- [Event Sourcing Pattern](https://docs.microsoft.com/en-us/azure/architecture/patterns/event-sourcing) diff --git a/plugins/backend-development/skills/microservices-patterns/SKILL.md b/plugins/backend-development/skills/microservices-patterns/SKILL.md index 11e0c0b..6dc44fc 100644 --- a/plugins/backend-development/skills/microservices-patterns/SKILL.md +++ b/plugins/backend-development/skills/microservices-patterns/SKILL.md @@ -562,34 +562,3 @@ async def call_payment_service(payment_data: dict): payment_data ) ``` - -## Resources - -- **references/service-decomposition-guide.md**: Breaking down monoliths -- **references/communication-patterns.md**: Sync vs async patterns -- **references/saga-implementation.md**: Distributed transactions -- **assets/circuit-breaker.py**: Production circuit breaker -- **assets/event-bus-template.py**: Kafka event bus implementation -- **assets/api-gateway-template.py**: Complete API gateway - -## Best Practices - -1. **Service Boundaries**: Align with business capabilities -2. **Database Per Service**: No shared databases -3. **API Contracts**: Versioned, backward compatible -4. **Async When Possible**: Events over direct calls -5. **Circuit Breakers**: Fail fast on service failures -6. **Distributed Tracing**: Track requests across services -7. **Service Registry**: Dynamic service discovery -8. **Health Checks**: Liveness and readiness probes - -## Common Pitfalls - -- **Distributed Monolith**: Tightly coupled services -- **Chatty Services**: Too many inter-service calls -- **Shared Databases**: Tight coupling through data -- **No Circuit Breakers**: Cascade failures -- **Synchronous Everything**: Tight coupling, poor resilience -- **Premature Microservices**: Starting with microservices -- **Ignoring Network Failures**: Assuming reliable network -- **No Compensation Logic**: Can't undo failed transactions diff --git a/plugins/backend-development/skills/projection-patterns/SKILL.md b/plugins/backend-development/skills/projection-patterns/SKILL.md index dd4ee8f..b201b22 100644 --- a/plugins/backend-development/skills/projection-patterns/SKILL.md +++ b/plugins/backend-development/skills/projection-patterns/SKILL.md @@ -483,8 +483,3 @@ class CustomerActivityProjection(Projection): - **Don't skip error handling** - Log and alert on failures - **Don't ignore ordering** - Events must be processed in order - **Don't over-normalize** - Denormalize for query patterns - -## Resources - -- [CQRS Pattern](https://docs.microsoft.com/en-us/azure/architecture/patterns/cqrs) -- [Projection Building Blocks](https://zimarev.com/blog/event-sourcing/projections/) diff --git a/plugins/backend-development/skills/saga-orchestration/SKILL.md b/plugins/backend-development/skills/saga-orchestration/SKILL.md index 68fcd25..1c4a7f6 100644 --- a/plugins/backend-development/skills/saga-orchestration/SKILL.md +++ b/plugins/backend-development/skills/saga-orchestration/SKILL.md @@ -477,8 +477,3 @@ class TimeoutSagaOrchestrator(SagaOrchestrator): - **Don't skip compensation testing** - Most critical part - **Don't couple services** - Use async messaging - **Don't ignore partial failures** - Handle gracefully - -## Resources - -- [Saga Pattern](https://microservices.io/patterns/data/saga.html) -- [Designing Data-Intensive Applications](https://dataintensive.net/) diff --git a/plugins/blockchain-web3/skills/defi-protocol-templates/SKILL.md b/plugins/blockchain-web3/skills/defi-protocol-templates/SKILL.md index 404efc5..451a378 100644 --- a/plugins/blockchain-web3/skills/defi-protocol-templates/SKILL.md +++ b/plugins/blockchain-web3/skills/defi-protocol-templates/SKILL.md @@ -422,33 +422,3 @@ contract FlashLoanReceiver is IFlashLoanReceiver { } } ``` - -## Resources - -- **references/staking.md**: Staking mechanics and reward distribution -- **references/liquidity-pools.md**: AMM mathematics and pricing -- **references/governance-tokens.md**: Governance and voting systems -- **references/lending-protocols.md**: Lending/borrowing implementation -- **references/flash-loans.md**: Flash loan security and use cases -- **assets/staking-contract.sol**: Production staking template -- **assets/amm-contract.sol**: Full AMM implementation -- **assets/governance-token.sol**: Governance system -- **assets/lending-protocol.sol**: Lending platform template - -## Best Practices - -1. **Use Established Libraries**: OpenZeppelin, Solmate -2. **Test Thoroughly**: Unit tests, integration tests, fuzzing -3. **Audit Before Launch**: Professional security audits -4. **Start Simple**: MVP first, add features incrementally -5. **Monitor**: Track contract health and user activity -6. **Upgradability**: Consider proxy patterns for upgrades -7. **Emergency Controls**: Pause mechanisms for critical issues - -## Common DeFi Patterns - -- **Time-Weighted Average Price (TWAP)**: Price oracle resistance -- **Liquidity Mining**: Incentivize liquidity provision -- **Vesting**: Lock tokens with gradual release -- **Multisig**: Require multiple signatures for critical operations -- **Timelocks**: Delay execution of governance decisions diff --git a/plugins/blockchain-web3/skills/nft-standards/SKILL.md b/plugins/blockchain-web3/skills/nft-standards/SKILL.md index 62a1e24..4199598 100644 --- a/plugins/blockchain-web3/skills/nft-standards/SKILL.md +++ b/plugins/blockchain-web3/skills/nft-standards/SKILL.md @@ -353,31 +353,3 @@ contract OptimizedNFT is ERC721A { } } ``` - -## Resources - -- **references/erc721.md**: ERC-721 specification details -- **references/erc1155.md**: ERC-1155 multi-token standard -- **references/metadata-standards.md**: Metadata best practices -- **references/enumeration.md**: Token enumeration patterns -- **assets/erc721-contract.sol**: Production ERC-721 template -- **assets/erc1155-contract.sol**: Production ERC-1155 template -- **assets/metadata-schema.json**: Standard metadata format -- **assets/metadata-uploader.py**: IPFS upload utility - -## Best Practices - -1. **Use OpenZeppelin**: Battle-tested implementations -2. **Pin Metadata**: Use IPFS with pinning service -3. **Implement Royalties**: EIP-2981 for marketplace compatibility -4. **Gas Optimization**: Use ERC721A for batch minting -5. **Reveal Mechanism**: Placeholder → reveal pattern -6. **Enumeration**: Support walletOfOwner for marketplaces -7. **Whitelist**: Merkle trees for efficient whitelisting - -## Marketplace Integration - -- OpenSea: ERC-721/1155, metadata standards -- LooksRare: Royalty enforcement -- Rarible: Protocol fees, lazy minting -- Blur: Gas-optimized trading diff --git a/plugins/blockchain-web3/skills/solidity-security/SKILL.md b/plugins/blockchain-web3/skills/solidity-security/SKILL.md index 33943c7..821eff6 100644 --- a/plugins/blockchain-web3/skills/solidity-security/SKILL.md +++ b/plugins/blockchain-web3/skills/solidity-security/SKILL.md @@ -494,32 +494,3 @@ contract WellDocumentedContract { } } ``` - -## Resources - -- **references/reentrancy.md**: Comprehensive reentrancy prevention -- **references/access-control.md**: Role-based access patterns -- **references/overflow-underflow.md**: SafeMath and integer safety -- **references/gas-optimization.md**: Gas saving techniques -- **references/vulnerability-patterns.md**: Common vulnerability catalog -- **assets/solidity-contracts-templates.sol**: Secure contract templates -- **assets/security-checklist.md**: Pre-audit checklist -- **scripts/analyze-contract.sh**: Static analysis tools - -## Tools for Security Analysis - -- **Slither**: Static analysis tool -- **Mythril**: Security analysis tool -- **Echidna**: Fuzzing tool -- **Manticore**: Symbolic execution -- **Securify**: Automated security scanner - -## Common Pitfalls - -1. **Using `tx.origin` for Authentication**: Use `msg.sender` instead -2. **Unchecked External Calls**: Always check return values -3. **Delegatecall to Untrusted Contracts**: Can hijack your contract -4. **Floating Pragma**: Pin to specific Solidity version -5. **Missing Events**: Emit events for state changes -6. **Excessive Gas in Loops**: Can hit block gas limit -7. **No Upgrade Path**: Consider proxy patterns if upgrades needed diff --git a/plugins/blockchain-web3/skills/web3-testing/SKILL.md b/plugins/blockchain-web3/skills/web3-testing/SKILL.md index d31f1d3..137c801 100644 --- a/plugins/blockchain-web3/skills/web3-testing/SKILL.md +++ b/plugins/blockchain-web3/skills/web3-testing/SKILL.md @@ -388,28 +388,3 @@ jobs: - name: Upload coverage to Codecov uses: codecov/codecov-action@v2 ``` - -## Resources - -- **references/hardhat-setup.md**: Hardhat configuration guide -- **references/foundry-setup.md**: Foundry testing framework -- **references/test-patterns.md**: Testing best practices -- **references/mainnet-forking.md**: Fork testing strategies -- **references/contract-verification.md**: Etherscan verification -- **assets/hardhat-config.js**: Complete Hardhat configuration -- **assets/test-suite.js**: Comprehensive test examples -- **assets/foundry.toml**: Foundry configuration -- **scripts/test-contract.sh**: Automated testing script - -## Best Practices - -1. **Test Coverage**: Aim for >90% coverage -2. **Edge Cases**: Test boundary conditions -3. **Gas Limits**: Verify functions don't hit block gas limit -4. **Reentrancy**: Test for reentrancy vulnerabilities -5. **Access Control**: Test unauthorized access attempts -6. **Events**: Verify event emissions -7. **Fixtures**: Use fixtures to avoid code duplication -8. **Mainnet Fork**: Test with real contracts -9. **Fuzzing**: Use property-based testing -10. **CI/CD**: Automate testing on every commit diff --git a/plugins/business-analytics/skills/data-storytelling/SKILL.md b/plugins/business-analytics/skills/data-storytelling/SKILL.md index bae4a8b..168ff8e 100644 --- a/plugins/business-analytics/skills/data-storytelling/SKILL.md +++ b/plugins/business-analytics/skills/data-storytelling/SKILL.md @@ -445,9 +445,3 @@ Present ranges: - **Don't use jargon** - Match audience vocabulary - **Don't show methodology first** - Context, then method - **Don't forget the narrative** - Numbers need meaning - -## Resources - -- [Storytelling with Data (Cole Nussbaumer)](https://www.storytellingwithdata.com/) -- [The Pyramid Principle (Barbara Minto)](https://www.amazon.com/Pyramid-Principle-Logic-Writing-Thinking/dp/0273710516) -- [Resonate (Nancy Duarte)](https://www.duarte.com/resonate/) diff --git a/plugins/business-analytics/skills/kpi-dashboard-design/SKILL.md b/plugins/business-analytics/skills/kpi-dashboard-design/SKILL.md index 2aaa401..dc04a93 100644 --- a/plugins/business-analytics/skills/kpi-dashboard-design/SKILL.md +++ b/plugins/business-analytics/skills/kpi-dashboard-design/SKILL.md @@ -420,9 +420,3 @@ for alert in alerts: - **Don't use 3D charts** - They distort perception - **Don't hide methodology** - Document calculations - **Don't ignore mobile** - Ensure responsive design - -## Resources - -- [Stephen Few's Dashboard Design](https://www.perceptualedge.com/articles/visual_business_intelligence/rules_for_using_color.pdf) -- [Edward Tufte's Principles](https://www.edwardtufte.com/tufte/) -- [Google Data Studio Gallery](https://datastudio.google.com/gallery) diff --git a/plugins/cicd-automation/skills/deployment-pipeline-design/SKILL.md b/plugins/cicd-automation/skills/deployment-pipeline-design/SKILL.md index d81c5a2..e68116b 100644 --- a/plugins/cicd-automation/skills/deployment-pipeline-design/SKILL.md +++ b/plugins/cicd-automation/skills/deployment-pipeline-design/SKILL.md @@ -351,10 +351,6 @@ kubectl rollout undo deployment/my-app --to-revision=3 fi ``` -## Reference Files - -- `references/pipeline-orchestration.md` - Complex pipeline patterns -- `assets/approval-gate-template.yml` - Approval workflow templates ## Related Skills diff --git a/plugins/cicd-automation/skills/github-actions-templates/SKILL.md b/plugins/cicd-automation/skills/github-actions-templates/SKILL.md index 691f4bc..e994c00 100644 --- a/plugins/cicd-automation/skills/github-actions-templates/SKILL.md +++ b/plugins/cicd-automation/skills/github-actions-templates/SKILL.md @@ -320,12 +320,6 @@ jobs: } ``` -## Reference Files - -- `assets/test-workflow.yml` - Testing workflow template -- `assets/deploy-workflow.yml` - Deployment workflow template -- `assets/matrix-build.yml` - Matrix build template -- `references/common-workflows.md` - Common workflow patterns ## Related Skills diff --git a/plugins/cicd-automation/skills/gitlab-ci-patterns/SKILL.md b/plugins/cicd-automation/skills/gitlab-ci-patterns/SKILL.md index 82e9523..1313baf 100644 --- a/plugins/cicd-automation/skills/gitlab-ci-patterns/SKILL.md +++ b/plugins/cicd-automation/skills/gitlab-ci-patterns/SKILL.md @@ -246,10 +246,6 @@ trigger-child: strategy: depend ``` -## Reference Files - -- `assets/gitlab-ci.yml.template` - Complete pipeline template -- `references/pipeline-stages.md` - Stage organization patterns ## Best Practices diff --git a/plugins/cicd-automation/skills/secrets-management/SKILL.md b/plugins/cicd-automation/skills/secrets-management/SKILL.md index 91da002..8b0dfa9 100644 --- a/plugins/cicd-automation/skills/secrets-management/SKILL.md +++ b/plugins/cicd-automation/skills/secrets-management/SKILL.md @@ -339,10 +339,6 @@ secret-scan: allow_failure: false ``` -## Reference Files - -- `references/vault-setup.md` - HashiCorp Vault configuration -- `references/github-secrets.md` - GitHub Secrets best practices ## Related Skills diff --git a/plugins/cloud-infrastructure/skills/cost-optimization/SKILL.md b/plugins/cloud-infrastructure/skills/cost-optimization/SKILL.md index 9d40043..387f907 100644 --- a/plugins/cloud-infrastructure/skills/cost-optimization/SKILL.md +++ b/plugins/cloud-infrastructure/skills/cost-optimization/SKILL.md @@ -284,10 +284,6 @@ resource "aws_cloudwatch_metric_alarm" "cpu_high" { - **GCP:** Cost Management, Recommender - **Multi-cloud:** CloudHealth, Cloudability, Kubecost -## Reference Files - -- `references/tagging-standards.md` - Tagging conventions -- `assets/cost-analysis-template.xlsx` - Cost analysis spreadsheet ## Related Skills diff --git a/plugins/cloud-infrastructure/skills/hybrid-cloud-networking/SKILL.md b/plugins/cloud-infrastructure/skills/hybrid-cloud-networking/SKILL.md index 0947a42..2bddf13 100644 --- a/plugins/cloud-infrastructure/skills/hybrid-cloud-networking/SKILL.md +++ b/plugins/cloud-infrastructure/skills/hybrid-cloud-networking/SKILL.md @@ -230,10 +230,6 @@ az network vpn-connection show-device-config-script 5. **Use Direct Connect** for high bandwidth 6. **Implement caching** to reduce traffic -## Reference Files - -- `references/vpn-setup.md` - VPN configuration guide -- `references/direct-connect.md` - Direct Connect setup ## Related Skills diff --git a/plugins/cloud-infrastructure/skills/istio-traffic-management/SKILL.md b/plugins/cloud-infrastructure/skills/istio-traffic-management/SKILL.md index 7ccff3a..2c090d2 100644 --- a/plugins/cloud-infrastructure/skills/istio-traffic-management/SKILL.md +++ b/plugins/cloud-infrastructure/skills/istio-traffic-management/SKILL.md @@ -319,9 +319,3 @@ istioctl proxy-config endpoints deploy/my-app # Debug traffic istioctl proxy-config log deploy/my-app --level debug ``` - -## Resources - -- [Istio Traffic Management](https://istio.io/latest/docs/concepts/traffic-management/) -- [Virtual Service Reference](https://istio.io/latest/docs/reference/config/networking/virtual-service/) -- [Destination Rule Reference](https://istio.io/latest/docs/reference/config/networking/destination-rule/) diff --git a/plugins/cloud-infrastructure/skills/linkerd-patterns/SKILL.md b/plugins/cloud-infrastructure/skills/linkerd-patterns/SKILL.md index 2f53f31..79901e7 100644 --- a/plugins/cloud-infrastructure/skills/linkerd-patterns/SKILL.md +++ b/plugins/cloud-infrastructure/skills/linkerd-patterns/SKILL.md @@ -303,9 +303,3 @@ linkerd viz tap deploy/my-app --to deploy/my-backend - **Don't over-configure** - Linkerd defaults are sensible - **Don't ignore ServiceProfiles** - They unlock advanced features - **Don't forget timeouts** - Set appropriate values per route - -## Resources - -- [Linkerd Documentation](https://linkerd.io/2.14/overview/) -- [Service Profiles](https://linkerd.io/2.14/features/service-profiles/) -- [Authorization Policy](https://linkerd.io/2.14/features/server-policy/) diff --git a/plugins/cloud-infrastructure/skills/mtls-configuration/SKILL.md b/plugins/cloud-infrastructure/skills/mtls-configuration/SKILL.md index 388871a..8bbfc5d 100644 --- a/plugins/cloud-infrastructure/skills/mtls-configuration/SKILL.md +++ b/plugins/cloud-infrastructure/skills/mtls-configuration/SKILL.md @@ -340,10 +340,3 @@ linkerd viz tap deploy/my-app --to deploy/my-backend - **Don't ignore cert expiry** - Automate rotation - **Don't use self-signed certs** - Use proper CA hierarchy - **Don't skip verification** - Verify the full chain - -## Resources - -- [Istio Security](https://istio.io/latest/docs/concepts/security/) -- [SPIFFE/SPIRE](https://spiffe.io/) -- [cert-manager](https://cert-manager.io/) -- [Zero Trust Architecture (NIST)](https://www.nist.gov/publications/zero-trust-architecture) diff --git a/plugins/cloud-infrastructure/skills/multi-cloud-architecture/SKILL.md b/plugins/cloud-infrastructure/skills/multi-cloud-architecture/SKILL.md index 5633d18..2d6fd3f 100644 --- a/plugins/cloud-infrastructure/skills/multi-cloud-architecture/SKILL.md +++ b/plugins/cloud-infrastructure/skills/multi-cloud-architecture/SKILL.md @@ -169,10 +169,6 @@ AWS / Azure / GCP 9. **Test disaster recovery** procedures 10. **Train teams** on multiple clouds -## Reference Files - -- `references/service-comparison.md` - Complete service comparison -- `references/multi-cloud-patterns.md` - Architecture patterns ## Related Skills diff --git a/plugins/cloud-infrastructure/skills/service-mesh-observability/SKILL.md b/plugins/cloud-infrastructure/skills/service-mesh-observability/SKILL.md index 62ca99d..32d0a7f 100644 --- a/plugins/cloud-infrastructure/skills/service-mesh-observability/SKILL.md +++ b/plugins/cloud-infrastructure/skills/service-mesh-observability/SKILL.md @@ -376,10 +376,3 @@ spec: - **Don't ignore cardinality** - Limit label values - **Don't skip dashboards** - Visualize dependencies - **Don't forget costs** - Monitor observability costs - -## Resources - -- [Istio Observability](https://istio.io/latest/docs/tasks/observability/) -- [Linkerd Observability](https://linkerd.io/2.14/features/dashboard/) -- [OpenTelemetry](https://opentelemetry.io/) -- [Kiali](https://kiali.io/) diff --git a/plugins/cloud-infrastructure/skills/terraform-module-library/SKILL.md b/plugins/cloud-infrastructure/skills/terraform-module-library/SKILL.md index e39eef1..f2cdf16 100644 --- a/plugins/cloud-infrastructure/skills/terraform-module-library/SKILL.md +++ b/plugins/cloud-infrastructure/skills/terraform-module-library/SKILL.md @@ -213,13 +213,6 @@ module "rds" { } ``` -## Reference Files - -- `assets/vpc-module/` - Complete VPC module example -- `assets/rds-module/` - RDS module example -- `references/aws-modules.md` - AWS module patterns -- `references/azure-modules.md` - Azure module patterns -- `references/gcp-modules.md` - GCP module patterns ## Testing diff --git a/plugins/data-engineering/skills/airflow-dag-patterns/SKILL.md b/plugins/data-engineering/skills/airflow-dag-patterns/SKILL.md index b15edc0..ef35241 100644 --- a/plugins/data-engineering/skills/airflow-dag-patterns/SKILL.md +++ b/plugins/data-engineering/skills/airflow-dag-patterns/SKILL.md @@ -517,9 +517,3 @@ airflow/ - **Don't use global state** - Tasks should be stateless - **Don't skip catchup blindly** - Understand implications - **Don't put heavy logic in DAG file** - Import from modules - -## Resources - -- [Airflow Documentation](https://airflow.apache.org/docs/) -- [Astronomer Guides](https://docs.astronomer.io/learn) -- [TaskFlow API](https://airflow.apache.org/docs/apache-airflow/stable/tutorial/taskflow.html) diff --git a/plugins/data-engineering/skills/data-quality-frameworks/SKILL.md b/plugins/data-engineering/skills/data-quality-frameworks/SKILL.md index 6de71fd..e1bf994 100644 --- a/plugins/data-engineering/skills/data-quality-frameworks/SKILL.md +++ b/plugins/data-engineering/skills/data-quality-frameworks/SKILL.md @@ -581,10 +581,3 @@ if not all(r.passed for r in results.values()): - **Don't skip freshness** - Stale data is bad data - **Don't hardcode thresholds** - Use dynamic baselines - **Don't test in isolation** - Test relationships too - -## Resources - -- [Great Expectations Documentation](https://docs.greatexpectations.io/) -- [dbt Testing Documentation](https://docs.getdbt.com/docs/build/tests) -- [Data Contract Specification](https://datacontract.com/) -- [Soda Core](https://docs.soda.io/soda-core/overview.html) diff --git a/plugins/data-engineering/skills/dbt-transformation-patterns/SKILL.md b/plugins/data-engineering/skills/dbt-transformation-patterns/SKILL.md index efd4e61..57624c4 100644 --- a/plugins/data-engineering/skills/dbt-transformation-patterns/SKILL.md +++ b/plugins/data-engineering/skills/dbt-transformation-patterns/SKILL.md @@ -554,10 +554,3 @@ dbt ls --select tag:critical # List models by tag - **Don't repeat logic** - Extract to macros - **Don't test in prod** - Use dev target - **Don't ignore freshness** - Monitor source data - -## Resources - -- [dbt Documentation](https://docs.getdbt.com/) -- [dbt Best Practices](https://docs.getdbt.com/guides/best-practices) -- [dbt-utils Package](https://hub.getdbt.com/dbt-labs/dbt_utils/latest/) -- [dbt Discourse](https://discourse.getdbt.com/) diff --git a/plugins/data-engineering/skills/spark-optimization/SKILL.md b/plugins/data-engineering/skills/spark-optimization/SKILL.md index c822645..c24b5a7 100644 --- a/plugins/data-engineering/skills/spark-optimization/SKILL.md +++ b/plugins/data-engineering/skills/spark-optimization/SKILL.md @@ -409,9 +409,3 @@ spark_configs = { - **Don't over-cache** - Memory is limited - **Don't ignore data skew** - It dominates job time - **Don't use `.count()` for existence** - Use `.take(1)` or `.isEmpty()` - -## Resources - -- [Spark Performance Tuning](https://spark.apache.org/docs/latest/sql-performance-tuning.html) -- [Spark Configuration](https://spark.apache.org/docs/latest/configuration.html) -- [Databricks Optimization Guide](https://docs.databricks.com/en/optimizations/index.html) diff --git a/plugins/developer-essentials/skills/auth-implementation-patterns/SKILL.md b/plugins/developer-essentials/skills/auth-implementation-patterns/SKILL.md index 6ad6f9f..09d8e60 100644 --- a/plugins/developer-essentials/skills/auth-implementation-patterns/SKILL.md +++ b/plugins/developer-essentials/skills/auth-implementation-patterns/SKILL.md @@ -636,12 +636,3 @@ app.use("/api/", apiLimiter); - **Insecure Password Reset**: Use secure tokens with expiration - **No Rate Limiting**: Vulnerable to brute force - **Trusting Client Data**: Always validate on server - -## Resources - -- **references/jwt-best-practices.md**: JWT implementation guide -- **references/oauth2-flows.md**: OAuth2 flow diagrams and examples -- **references/session-security.md**: Secure session management -- **assets/auth-security-checklist.md**: Security review checklist -- **assets/password-policy-template.md**: Password requirements template -- **scripts/token-validator.ts**: JWT validation utility diff --git a/plugins/developer-essentials/skills/bazel-build-optimization/SKILL.md b/plugins/developer-essentials/skills/bazel-build-optimization/SKILL.md index ced948c..fdc96cb 100644 --- a/plugins/developer-essentials/skills/bazel-build-optimization/SKILL.md +++ b/plugins/developer-essentials/skills/bazel-build-optimization/SKILL.md @@ -379,9 +379,3 @@ bazel build //... --notrack_incremental_state - **Don't commit bazel-\* dirs** - Add to .gitignore - **Don't skip WORKSPACE setup** - Foundation of build - **Don't ignore build warnings** - Technical debt - -## Resources - -- [Bazel Documentation](https://bazel.build/docs) -- [Bazel Remote Execution](https://bazel.build/docs/remote-execution) -- [rules_js](https://github.com/aspect-build/rules_js) diff --git a/plugins/developer-essentials/skills/code-review-excellence/SKILL.md b/plugins/developer-essentials/skills/code-review-excellence/SKILL.md index 0a035ec..747aae2 100644 --- a/plugins/developer-essentials/skills/code-review-excellence/SKILL.md +++ b/plugins/developer-essentials/skills/code-review-excellence/SKILL.md @@ -527,12 +527,3 @@ When author disagrees with your feedback: ✅ Approve after addressing required changes ``` - -## Resources - -- **references/code-review-best-practices.md**: Comprehensive review guidelines -- **references/common-bugs-checklist.md**: Language-specific bugs to watch for -- **references/security-review-guide.md**: Security-focused review checklist -- **assets/pr-review-template.md**: Standard review comment template -- **assets/review-checklist.md**: Quick reference checklist -- **scripts/pr-analyzer.py**: Analyze PR complexity and suggest reviewers diff --git a/plugins/developer-essentials/skills/debugging-strategies/SKILL.md b/plugins/developer-essentials/skills/debugging-strategies/SKILL.md index 5a95777..897dbd1 100644 --- a/plugins/developer-essentials/skills/debugging-strategies/SKILL.md +++ b/plugins/developer-essentials/skills/debugging-strategies/SKILL.md @@ -525,12 +525,3 @@ afterEach(() => { - [ ] Cache issues (clear cache) - [ ] Stale data (refresh database) ``` - -## Resources - -- **references/debugging-tools-guide.md**: Comprehensive tool documentation -- **references/performance-profiling.md**: Performance debugging guide -- **references/production-debugging.md**: Debugging live systems -- **assets/debugging-checklist.md**: Quick reference checklist -- **assets/common-bugs.md**: Common bug patterns -- **scripts/debug-helper.ts**: Debugging utility functions diff --git a/plugins/developer-essentials/skills/e2e-testing-patterns/SKILL.md b/plugins/developer-essentials/skills/e2e-testing-patterns/SKILL.md index 92686be..49d477e 100644 --- a/plugins/developer-essentials/skills/e2e-testing-patterns/SKILL.md +++ b/plugins/developer-essentials/skills/e2e-testing-patterns/SKILL.md @@ -533,12 +533,3 @@ test('checkout flow', async ({ page }) => { // 5. Inspect page state await page.pause(); // Pauses execution, opens inspector ``` - -## Resources - -- **references/playwright-best-practices.md**: Playwright-specific patterns -- **references/cypress-best-practices.md**: Cypress-specific patterns -- **references/flaky-test-debugging.md**: Debugging unreliable tests -- **assets/e2e-testing-checklist.md**: What to test with E2E -- **assets/selector-strategies.md**: Finding reliable selectors -- **scripts/test-analyzer.ts**: Analyze test flakiness and duration diff --git a/plugins/developer-essentials/skills/error-handling-patterns/SKILL.md b/plugins/developer-essentials/skills/error-handling-patterns/SKILL.md index 77710fa..d8834e2 100644 --- a/plugins/developer-essentials/skills/error-handling-patterns/SKILL.md +++ b/plugins/developer-essentials/skills/error-handling-patterns/SKILL.md @@ -630,12 +630,3 @@ def process_order(order_id: str) -> Order: - **Poor Error Messages**: "Error occurred" is not helpful - **Returning Error Codes**: Use exceptions or Result types - **Ignoring Async Errors**: Unhandled promise rejections - -## Resources - -- **references/exception-hierarchy-design.md**: Designing error class hierarchies -- **references/error-recovery-strategies.md**: Recovery patterns for different scenarios -- **references/async-error-handling.md**: Handling errors in concurrent code -- **assets/error-handling-checklist.md**: Review checklist for error handling -- **assets/error-message-guide.md**: Writing helpful error messages -- **scripts/error-analyzer.py**: Analyze error patterns in logs diff --git a/plugins/developer-essentials/skills/git-advanced-workflows/SKILL.md b/plugins/developer-essentials/skills/git-advanced-workflows/SKILL.md index 1314432..3b50025 100644 --- a/plugins/developer-essentials/skills/git-advanced-workflows/SKILL.md +++ b/plugins/developer-essentials/skills/git-advanced-workflows/SKILL.md @@ -394,12 +394,3 @@ git reset --hard HEAD^ git reflog git branch recovered-branch abc123 ``` - -## Resources - -- **references/git-rebase-guide.md**: Deep dive into interactive rebase -- **references/git-conflict-resolution.md**: Advanced conflict resolution strategies -- **references/git-history-rewriting.md**: Safely rewriting Git history -- **assets/git-workflow-checklist.md**: Pre-PR cleanup checklist -- **assets/git-aliases.md**: Useful Git aliases for advanced workflows -- **scripts/git-clean-branches.sh**: Clean up merged and stale branches diff --git a/plugins/developer-essentials/skills/monorepo-management/SKILL.md b/plugins/developer-essentials/skills/monorepo-management/SKILL.md index 4c549eb..ae4b380 100644 --- a/plugins/developer-essentials/skills/monorepo-management/SKILL.md +++ b/plugins/developer-essentials/skills/monorepo-management/SKILL.md @@ -612,12 +612,3 @@ pnpm changeset publish GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} NPM_TOKEN: ${{ secrets.NPM_TOKEN }} ``` - -## Resources - -- **references/turborepo-guide.md**: Comprehensive Turborepo documentation -- **references/nx-guide.md**: Nx monorepo patterns -- **references/pnpm-workspaces.md**: pnpm workspace features -- **assets/monorepo-checklist.md**: Setup checklist -- **assets/migration-guide.md**: Multi-repo to monorepo migration -- **scripts/dependency-graph.ts**: Visualize package dependencies diff --git a/plugins/developer-essentials/skills/nx-workspace-patterns/SKILL.md b/plugins/developer-essentials/skills/nx-workspace-patterns/SKILL.md index 10ae77b..5cb5323 100644 --- a/plugins/developer-essentials/skills/nx-workspace-patterns/SKILL.md +++ b/plugins/developer-essentials/skills/nx-workspace-patterns/SKILL.md @@ -449,9 +449,3 @@ nx migrate --run-migrations - **Don't skip affected** - Test only what changed - **Don't ignore boundaries** - Tech debt accumulates - **Don't over-granularize** - Balance lib count - -## Resources - -- [Nx Documentation](https://nx.dev/getting-started/intro) -- [Module Boundaries](https://nx.dev/core-features/enforce-module-boundaries) -- [Nx Cloud](https://nx.app/) diff --git a/plugins/developer-essentials/skills/sql-optimization-patterns/SKILL.md b/plugins/developer-essentials/skills/sql-optimization-patterns/SKILL.md index ef3600a..a45fbea 100644 --- a/plugins/developer-essentials/skills/sql-optimization-patterns/SKILL.md +++ b/plugins/developer-essentials/skills/sql-optimization-patterns/SKILL.md @@ -497,13 +497,3 @@ FROM pg_stat_user_indexes WHERE idx_scan = 0 ORDER BY pg_relation_size(indexrelid) DESC; ``` - -## Resources - -- **references/postgres-optimization-guide.md**: PostgreSQL-specific optimization -- **references/mysql-optimization-guide.md**: MySQL/MariaDB optimization -- **references/query-plan-analysis.md**: Deep dive into EXPLAIN plans -- **assets/index-strategy-checklist.md**: When and how to create indexes -- **assets/query-optimization-checklist.md**: Step-by-step optimization guide -- **scripts/analyze-slow-queries.sql**: Identify slow queries in your database -- **scripts/index-recommendations.sql**: Generate index recommendations diff --git a/plugins/developer-essentials/skills/turborepo-caching/SKILL.md b/plugins/developer-essentials/skills/turborepo-caching/SKILL.md index ca31d10..0d20844 100644 --- a/plugins/developer-essentials/skills/turborepo-caching/SKILL.md +++ b/plugins/developer-essentials/skills/turborepo-caching/SKILL.md @@ -368,9 +368,3 @@ TURBO_LOG_VERBOSITY=debug turbo build --filter=@myorg/web - **Don't include secrets in env** - Use runtime env vars - **Don't ignore dependsOn** - Causes race conditions - **Don't over-filter** - May miss dependencies - -## Resources - -- [Turborepo Documentation](https://turbo.build/repo/docs) -- [Caching Guide](https://turbo.build/repo/docs/core-concepts/caching) -- [Remote Caching](https://turbo.build/repo/docs/core-concepts/remote-caching) diff --git a/plugins/documentation-generation/skills/architecture-decision-records/SKILL.md b/plugins/documentation-generation/skills/architecture-decision-records/SKILL.md index ed546ab..d77a13c 100644 --- a/plugins/documentation-generation/skills/architecture-decision-records/SKILL.md +++ b/plugins/documentation-generation/skills/architecture-decision-records/SKILL.md @@ -439,10 +439,3 @@ adr link 2 "Complements" 1 "Is complemented by" - **Don't hide failures** - Rejected decisions are valuable - **Don't be vague** - Specific decisions, specific consequences - **Don't forget implementation** - ADR without action is waste - -## Resources - -- [Documenting Architecture Decisions (Michael Nygard)](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions) -- [MADR Template](https://adr.github.io/madr/) -- [ADR GitHub Organization](https://adr.github.io/) -- [adr-tools](https://github.com/npryce/adr-tools) diff --git a/plugins/documentation-generation/skills/changelog-automation/SKILL.md b/plugins/documentation-generation/skills/changelog-automation/SKILL.md index 0c05a4e..85faae0 100644 --- a/plugins/documentation-generation/skills/changelog-automation/SKILL.md +++ b/plugins/documentation-generation/skills/changelog-automation/SKILL.md @@ -570,11 +570,3 @@ Reviewed-by: @alice - **Don't manual edit** - Generated changelogs only - **Don't forget breaking changes** - Mark with `!` or footer - **Don't ignore CI** - Validate commits in pipeline - -## Resources - -- [Keep a Changelog](https://keepachangelog.com/) -- [Conventional Commits](https://www.conventionalcommits.org/) -- [Semantic Versioning](https://semver.org/) -- [semantic-release](https://semantic-release.gitbook.io/) -- [git-cliff](https://git-cliff.org/) diff --git a/plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md b/plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md index 199e2b6..e953133 100644 --- a/plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md +++ b/plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md @@ -1015,10 +1015,3 @@ openapi-generator-cli generate \ - **Don't forget nullable** - Be explicit about null - **Don't mix styles** - Consistent naming throughout - **Don't hardcode URLs** - Use server variables - -## Resources - -- [OpenAPI 3.1 Specification](https://spec.openapis.org/oas/v3.1.0) -- [Swagger Editor](https://editor.swagger.io/) -- [Redocly](https://redocly.com/) -- [Spectral](https://stoplight.io/open-source/spectral) diff --git a/plugins/dotnet-contribution/skills/dotnet-backend-patterns/SKILL.md b/plugins/dotnet-contribution/skills/dotnet-backend-patterns/SKILL.md index 5366a60..7eaaab9 100644 --- a/plugins/dotnet-contribution/skills/dotnet-backend-patterns/SKILL.md +++ b/plugins/dotnet-contribution/skills/dotnet-backend-patterns/SKILL.md @@ -808,10 +808,3 @@ public class ProductsApiTests : IClassFixture> - **Missing Indexes**: Check query plans, add indexes for common filters - **Timeout Issues**: Configure appropriate timeouts for HTTP clients - **Cache Stampede**: Use distributed locks for cache population - -## Resources - -- **assets/service-template.cs**: Complete service implementation template -- **assets/repository-template.cs**: Repository pattern implementation -- **references/ef-core-best-practices.md**: EF Core optimization guide -- **references/dapper-patterns.md**: Advanced Dapper usage patterns diff --git a/plugins/framework-migration/skills/angular-migration/SKILL.md b/plugins/framework-migration/skills/angular-migration/SKILL.md index 196bedd..517cecd 100644 --- a/plugins/framework-migration/skills/angular-migration/SKILL.md +++ b/plugins/framework-migration/skills/angular-migration/SKILL.md @@ -384,32 +384,3 @@ Phase 4: Cleanup (1-2 weeks) - Optimize bundle - Final testing ``` - -## Resources - -- **references/hybrid-mode.md**: Hybrid app patterns -- **references/component-migration.md**: Component conversion guide -- **references/dependency-injection.md**: DI migration strategies -- **references/routing.md**: Routing migration -- **assets/hybrid-bootstrap.ts**: Hybrid app template -- **assets/migration-timeline.md**: Project planning -- **scripts/analyze-angular-app.sh**: App analysis script - -## Best Practices - -1. **Start with Services**: Migrate services first (easier) -2. **Incremental Approach**: Feature-by-feature migration -3. **Test Continuously**: Test at every step -4. **Use TypeScript**: Migrate to TypeScript early -5. **Follow Style Guide**: Angular style guide from day 1 -6. **Optimize Later**: Get it working, then optimize -7. **Document**: Keep migration notes - -## Common Pitfalls - -- Not setting up hybrid app correctly -- Migrating UI before logic -- Ignoring change detection differences -- Not handling scope properly -- Mixing patterns (AngularJS + Angular) -- Inadequate testing diff --git a/plugins/framework-migration/skills/database-migration/SKILL.md b/plugins/framework-migration/skills/database-migration/SKILL.md index 7ce4caa..c737a95 100644 --- a/plugins/framework-migration/skills/database-migration/SKILL.md +++ b/plugins/framework-migration/skills/database-migration/SKILL.md @@ -401,33 +401,3 @@ module.exports = { }, }; ``` - -## Resources - -- **references/orm-switching.md**: ORM migration guides -- **references/schema-migration.md**: Schema transformation patterns -- **references/data-transformation.md**: Data migration scripts -- **references/rollback-strategies.md**: Rollback procedures -- **assets/schema-migration-template.sql**: SQL migration templates -- **assets/data-migration-script.py**: Data migration utilities -- **scripts/test-migration.sh**: Migration testing script - -## Best Practices - -1. **Always Provide Rollback**: Every up() needs a down() -2. **Test Migrations**: Test on staging first -3. **Use Transactions**: Atomic migrations when possible -4. **Backup First**: Always backup before migration -5. **Small Changes**: Break into small, incremental steps -6. **Monitor**: Watch for errors during deployment -7. **Document**: Explain why and how -8. **Idempotent**: Migrations should be rerunnable - -## Common Pitfalls - -- Not testing rollback procedures -- Making breaking changes without downtime strategy -- Forgetting to handle NULL values -- Not considering index performance -- Ignoring foreign key constraints -- Migrating too much data at once diff --git a/plugins/framework-migration/skills/dependency-upgrade/SKILL.md b/plugins/framework-migration/skills/dependency-upgrade/SKILL.md index 26c2cd3..88aa04a 100644 --- a/plugins/framework-migration/skills/dependency-upgrade/SKILL.md +++ b/plugins/framework-migration/skills/dependency-upgrade/SKILL.md @@ -366,64 +366,3 @@ npm install --workspaces # Update specific workspace npm install package@latest --workspace=packages/app ``` - -## Resources - -- **references/semver.md**: Semantic versioning guide -- **references/compatibility-matrix.md**: Common compatibility issues -- **references/staged-upgrades.md**: Incremental upgrade strategies -- **references/testing-strategy.md**: Comprehensive testing approaches -- **assets/upgrade-checklist.md**: Step-by-step checklist -- **assets/compatibility-matrix.csv**: Version compatibility table -- **scripts/audit-dependencies.sh**: Dependency audit script - -## Best Practices - -1. **Read Changelogs**: Understand what changed -2. **Upgrade Incrementally**: One major version at a time -3. **Test Thoroughly**: Unit, integration, E2E tests -4. **Check Peer Dependencies**: Resolve conflicts early -5. **Use Lock Files**: Ensure reproducible installs -6. **Automate Updates**: Use Renovate or Dependabot -7. **Monitor**: Watch for runtime errors post-upgrade -8. **Document**: Keep upgrade notes - -## Upgrade Checklist - -```markdown -Pre-Upgrade: - -- [ ] Review current dependency versions -- [ ] Read changelogs for breaking changes -- [ ] Create feature branch -- [ ] Backup current state (git tag) -- [ ] Run full test suite (baseline) - -During Upgrade: - -- [ ] Upgrade one dependency at a time -- [ ] Update peer dependencies -- [ ] Fix TypeScript errors -- [ ] Update tests if needed -- [ ] Run test suite after each upgrade -- [ ] Check bundle size impact - -Post-Upgrade: - -- [ ] Full regression testing -- [ ] Performance testing -- [ ] Update documentation -- [ ] Deploy to staging -- [ ] Monitor for errors -- [ ] Deploy to production -``` - -## Common Pitfalls - -- Upgrading all dependencies at once -- Not testing after each upgrade -- Ignoring peer dependency warnings -- Forgetting to update lock file -- Not reading breaking change notes -- Skipping major versions -- Not having rollback plan diff --git a/plugins/framework-migration/skills/react-modernization/SKILL.md b/plugins/framework-migration/skills/react-modernization/SKILL.md index 72970e6..6ed5827 100644 --- a/plugins/framework-migration/skills/react-modernization/SKILL.md +++ b/plugins/framework-migration/skills/react-modernization/SKILL.md @@ -495,32 +495,3 @@ function List({ items, renderItem }: ListProps) { - [ ] Check for warnings in console - [ ] Performance testing ``` - -## Resources - -- **references/breaking-changes.md**: Version-specific breaking changes -- **references/codemods.md**: Codemod usage guide -- **references/hooks-migration.md**: Comprehensive hooks patterns -- **references/concurrent-features.md**: React 18 concurrent features -- **assets/codemod-config.json**: Codemod configurations -- **assets/migration-checklist.md**: Step-by-step checklist -- **scripts/apply-codemods.sh**: Automated codemod script - -## Best Practices - -1. **Incremental Migration**: Don't migrate everything at once -2. **Test Thoroughly**: Comprehensive testing at each step -3. **Use Codemods**: Automate repetitive transformations -4. **Start Simple**: Begin with leaf components -5. **Leverage StrictMode**: Catch issues early -6. **Monitor Performance**: Measure before and after -7. **Document Changes**: Keep migration log - -## Common Pitfalls - -- Forgetting useEffect dependencies -- Over-using useMemo/useCallback -- Not handling cleanup in useEffect -- Mixing class and functional patterns -- Ignoring StrictMode warnings -- Breaking change assumptions diff --git a/plugins/frontend-mobile-development/skills/nextjs-app-router-patterns/SKILL.md b/plugins/frontend-mobile-development/skills/nextjs-app-router-patterns/SKILL.md index dec1df2..9a3c48f 100644 --- a/plugins/frontend-mobile-development/skills/nextjs-app-router-patterns/SKILL.md +++ b/plugins/frontend-mobile-development/skills/nextjs-app-router-patterns/SKILL.md @@ -535,9 +535,3 @@ export async function updateProduct(id: string, data: ProductData) { - **Don't fetch in Client Components** - Use Server Components or React Query - **Don't over-nest layouts** - Each layout adds to the component tree - **Don't ignore loading states** - Always provide loading.tsx or Suspense - -## Resources - -- [Next.js App Router Documentation](https://nextjs.org/docs/app) -- [Server Components RFC](https://github.com/reactjs/rfcs/blob/main/text/0188-server-components.md) -- [Vercel Templates](https://vercel.com/templates/next.js) diff --git a/plugins/frontend-mobile-development/skills/react-native-architecture/SKILL.md b/plugins/frontend-mobile-development/skills/react-native-architecture/SKILL.md index 6fc70e3..7ade7a0 100644 --- a/plugins/frontend-mobile-development/skills/react-native-architecture/SKILL.md +++ b/plugins/frontend-mobile-development/skills/react-native-architecture/SKILL.md @@ -664,10 +664,3 @@ eas update --branch production --message "Bug fixes" - **Don't ignore platform differences** - Test on both iOS and Android - **Don't store secrets in code** - Use environment variables - **Don't skip error boundaries** - Mobile crashes are unforgiving - -## Resources - -- [Expo Documentation](https://docs.expo.dev/) -- [Expo Router](https://docs.expo.dev/router/introduction/) -- [React Native Performance](https://reactnative.dev/docs/performance) -- [FlashList](https://shopify.github.io/flash-list/) diff --git a/plugins/frontend-mobile-development/skills/react-state-management/SKILL.md b/plugins/frontend-mobile-development/skills/react-state-management/SKILL.md index 99ba3cb..1198b52 100644 --- a/plugins/frontend-mobile-development/skills/react-state-management/SKILL.md +++ b/plugins/frontend-mobile-development/skills/react-state-management/SKILL.md @@ -428,10 +428,3 @@ const todosSlice = createSlice({ }, }); ``` - -## Resources - -- [Redux Toolkit Documentation](https://redux-toolkit.js.org/) -- [Zustand GitHub](https://github.com/pmndrs/zustand) -- [Jotai Documentation](https://jotai.org/) -- [TanStack Query](https://tanstack.com/query) diff --git a/plugins/frontend-mobile-development/skills/tailwind-design-system/SKILL.md b/plugins/frontend-mobile-development/skills/tailwind-design-system/SKILL.md index 0a8f806..7df5760 100644 --- a/plugins/frontend-mobile-development/skills/tailwind-design-system/SKILL.md +++ b/plugins/frontend-mobile-development/skills/tailwind-design-system/SKILL.md @@ -864,11 +864,3 @@ Define reusable custom utilities: - **Don't use arbitrary values** - Extend `@theme` instead - **Don't hardcode colors** - Use semantic tokens - **Don't forget dark mode** - Test both themes - -## Resources - -- [Tailwind CSS v4 Documentation](https://tailwindcss.com/docs) -- [Tailwind v4 Beta Announcement](https://tailwindcss.com/blog/tailwindcss-v4-beta) -- [CVA Documentation](https://cva.style/docs) -- [shadcn/ui](https://ui.shadcn.com/) -- [Radix Primitives](https://www.radix-ui.com/primitives) diff --git a/plugins/game-development/skills/godot-gdscript-patterns/SKILL.md b/plugins/game-development/skills/godot-gdscript-patterns/SKILL.md index ef80d5d..b021384 100644 --- a/plugins/game-development/skills/godot-gdscript-patterns/SKILL.md +++ b/plugins/game-development/skills/godot-gdscript-patterns/SKILL.md @@ -799,9 +799,3 @@ func _on_off_screen() -> void: - **Don't put logic in resources** - Keep them data-only - **Don't ignore the Profiler** - Monitor performance - **Don't fight the scene tree** - Work with Godot's design - -## Resources - -- [Godot Documentation](https://docs.godotengine.org/en/stable/) -- [GDQuest Tutorials](https://www.gdquest.com/) -- [Godot Recipes](https://kidscancode.org/godot_recipes/) diff --git a/plugins/game-development/skills/unity-ecs-patterns/SKILL.md b/plugins/game-development/skills/unity-ecs-patterns/SKILL.md index c755859..21cdcd2 100644 --- a/plugins/game-development/skills/unity-ecs-patterns/SKILL.md +++ b/plugins/game-development/skills/unity-ecs-patterns/SKILL.md @@ -620,9 +620,3 @@ public struct Disabled : IComponentData, IEnableableComponent { } - **Don't over-architect** - Start simple - **Don't ignore chunk utilization** - Group similar entities - **Don't forget disposal** - Native collections leak - -## Resources - -- [Unity DOTS Documentation](https://docs.unity3d.com/Packages/com.unity.entities@latest) -- [Unity DOTS Samples](https://github.com/Unity-Technologies/EntityComponentSystemSamples) -- [Burst User Guide](https://docs.unity3d.com/Packages/com.unity.burst@latest) diff --git a/plugins/hr-legal-compliance/skills/employment-contract-templates/SKILL.md b/plugins/hr-legal-compliance/skills/employment-contract-templates/SKILL.md index ddeccb4..2673cfd 100644 --- a/plugins/hr-legal-compliance/skills/employment-contract-templates/SKILL.md +++ b/plugins/hr-legal-compliance/skills/employment-contract-templates/SKILL.md @@ -518,10 +518,3 @@ Date: ************\_************ - **Don't discriminate** - In language or application - **Don't forget at-will language** - Where applicable - **Don't skip review** - Have legal counsel review all documents - -## Resources - -- [SHRM Employment Templates](https://www.shrm.org/) -- [Department of Labor](https://www.dol.gov/) -- [EEOC Guidance](https://www.eeoc.gov/) -- State-specific labor departments diff --git a/plugins/hr-legal-compliance/skills/gdpr-data-handling/SKILL.md b/plugins/hr-legal-compliance/skills/gdpr-data-handling/SKILL.md index dc3ec78..dfc8b13 100644 --- a/plugins/hr-legal-compliance/skills/gdpr-data-handling/SKILL.md +++ b/plugins/hr-legal-compliance/skills/gdpr-data-handling/SKILL.md @@ -622,9 +622,3 @@ class BreachNotificationHandler: - **Don't retain indefinitely** - Define and enforce retention - **Don't ignore DSARs** - 30-day response required - **Don't transfer without safeguards** - SCCs or adequacy decisions - -## Resources - -- [GDPR Full Text](https://gdpr-info.eu/) -- [ICO Guidance](https://ico.org.uk/for-organisations/guide-to-data-protection/guide-to-the-general-data-protection-regulation-gdpr/) -- [EDPB Guidelines](https://edpb.europa.eu/our-work-tools/general-guidance/gdpr-guidelines-recommendations-best-practices_en) diff --git a/plugins/incident-response/skills/incident-runbook-templates/SKILL.md b/plugins/incident-response/skills/incident-runbook-templates/SKILL.md index 6b8403e..ed04813 100644 --- a/plugins/incident-response/skills/incident-runbook-templates/SKILL.md +++ b/plugins/incident-response/skills/incident-runbook-templates/SKILL.md @@ -397,10 +397,3 @@ psql -c "VACUUM FULL large_table;" - **Don't forget communication** - Keep stakeholders informed - **Don't work alone** - Escalate early - **Don't skip postmortems** - Learn from every incident - -## Resources - -- [Google SRE Book - Incident Management](https://sre.google/sre-book/managing-incidents/) -- [PagerDuty Incident Response](https://response.pagerduty.com/) -- [Atlassian Incident Management](https://www.atlassian.com/incident-management) -``` diff --git a/plugins/incident-response/skills/on-call-handoff-patterns/SKILL.md b/plugins/incident-response/skills/on-call-handoff-patterns/SKILL.md index 38aad04..82906ba 100644 --- a/plugins/incident-response/skills/on-call-handoff-patterns/SKILL.md +++ b/plugins/incident-response/skills/on-call-handoff-patterns/SKILL.md @@ -307,176 +307,3 @@ I'll be available on Slack until 17:00 today. - Status page: Updated at 08:45 - Customer support: Notified - Exec team: Aware - -## Resources - -- Incident channel: #inc-20240122-payment -- Dashboard: [Payment Service](https://grafana/d/payments) -- Runbook: [Payment Degradation](https://wiki/runbooks/payments) - ---- - -**Incoming on-call (@bob) - Please confirm you have:** - -- [ ] Joined #inc-20240122-payment -- [ ] Access to dashboards -- [ ] Understand current state -- [ ] Know escalation path -``` - -## Handoff Sync Meeting - -### Agenda (15 minutes) - -```markdown -## Handoff Sync: @alice → @bob - -1. **Active Issues** (5 min) - - Walk through any ongoing incidents - - Discuss investigation status - - Transfer context and theories - -2. **Recent Changes** (3 min) - - Deployments to watch - - Config changes - - Known regressions - -3. **Upcoming Events** (3 min) - - Maintenance windows - - Expected traffic changes - - Releases planned - -4. **Questions** (4 min) - - Clarify anything unclear - - Confirm access and alerting - - Exchange contact info -``` - -## On-Call Best Practices - -### Before Your Shift - -```markdown -## Pre-Shift Checklist - -### Access Verification - -- [ ] VPN working -- [ ] kubectl access to all clusters -- [ ] Database read access -- [ ] Log aggregator access (Splunk/Datadog) -- [ ] PagerDuty app installed and logged in - -### Alerting Setup - -- [ ] PagerDuty schedule shows you as primary -- [ ] Phone notifications enabled -- [ ] Slack notifications for incident channels -- [ ] Test alert received and acknowledged - -### Knowledge Refresh - -- [ ] Review recent incidents (past 2 weeks) -- [ ] Check service changelog -- [ ] Skim critical runbooks -- [ ] Know escalation contacts - -### Environment Ready - -- [ ] Laptop charged and accessible -- [ ] Phone charged -- [ ] Quiet space available for calls -- [ ] Secondary contact identified (if traveling) -``` - -### During Your Shift - -```markdown -## Daily On-Call Routine - -### Morning (start of day) - -- [ ] Check overnight alerts -- [ ] Review dashboards for anomalies -- [ ] Check for any P0/P1 tickets created -- [ ] Skim incident channels for context - -### Throughout Day - -- [ ] Respond to alerts within SLA -- [ ] Document investigation progress -- [ ] Update team on significant issues -- [ ] Triage incoming pages - -### End of Day - -- [ ] Hand off any active issues -- [ ] Update investigation docs -- [ ] Note anything for next shift -``` - -### After Your Shift - -```markdown -## Post-Shift Checklist - -- [ ] Complete handoff document -- [ ] Sync with incoming on-call -- [ ] Verify PagerDuty routing changed -- [ ] Close/update investigation tickets -- [ ] File postmortems for any incidents -- [ ] Take time off if shift was stressful -``` - -## Escalation Guidelines - -### When to Escalate - -```markdown -## Escalation Triggers - -### Immediate Escalation - -- SEV1 incident declared -- Data breach suspected -- Unable to diagnose within 30 min -- Customer or legal escalation received - -### Consider Escalation - -- Issue spans multiple teams -- Requires expertise you don't have -- Business impact exceeds threshold -- You're uncertain about next steps - -### How to Escalate - -1. Page the appropriate escalation path -2. Provide brief context in Slack -3. Stay engaged until escalation acknowledges -4. Hand off cleanly, don't just disappear -``` - -## Best Practices - -### Do's - -- **Document everything** - Future you will thank you -- **Escalate early** - Better safe than sorry -- **Take breaks** - Alert fatigue is real -- **Keep handoffs synchronous** - Async loses context -- **Test your setup** - Before incidents, not during - -### Don'ts - -- **Don't skip handoffs** - Context loss causes incidents -- **Don't hero** - Escalate when needed -- **Don't ignore alerts** - Even if they seem minor -- **Don't work sick** - Swap shifts instead -- **Don't disappear** - Stay reachable during shift - -## Resources - -- [Google SRE - Being On-Call](https://sre.google/sre-book/being-on-call/) -- [PagerDuty On-Call Guide](https://www.pagerduty.com/resources/learn/on-call-management/) -- [Increment On-Call Issue](https://increment.com/on-call/) diff --git a/plugins/incident-response/skills/postmortem-writing/SKILL.md b/plugins/incident-response/skills/postmortem-writing/SKILL.md index a0067dd..7238056 100644 --- a/plugins/incident-response/skills/postmortem-writing/SKILL.md +++ b/plugins/incident-response/skills/postmortem-writing/SKILL.md @@ -388,9 +388,3 @@ Don't full-flush cache in production; use targeted invalidation. - **Don't make it a blame doc** - That kills learning - **Don't create busywork** - Actions should be meaningful - **Don't skip follow-up** - Verify actions completed - -## Resources - -- [Google SRE - Postmortem Culture](https://sre.google/sre-book/postmortem-culture/) -- [Etsy's Blameless Postmortems](https://codeascraft.com/2012/05/22/blameless-postmortems/) -- [PagerDuty Postmortem Guide](https://postmortems.pagerduty.com/) diff --git a/plugins/javascript-typescript/skills/javascript-testing-patterns/SKILL.md b/plugins/javascript-typescript/skills/javascript-testing-patterns/SKILL.md index 2c43967..9b51742 100644 --- a/plugins/javascript-typescript/skills/javascript-testing-patterns/SKILL.md +++ b/plugins/javascript-typescript/skills/javascript-testing-patterns/SKILL.md @@ -1012,10 +1012,3 @@ it("should call function after delay", () => { vi.useRealTimers(); }); ``` - -## Resources - -- **Jest Documentation**: https://jestjs.io/ -- **Vitest Documentation**: https://vitest.dev/ -- **Testing Library**: https://testing-library.com/ -- **Kent C. Dodds Testing Blog**: https://kentcdodds.com/blog/ diff --git a/plugins/javascript-typescript/skills/modern-javascript-patterns/SKILL.md b/plugins/javascript-typescript/skills/modern-javascript-patterns/SKILL.md index 4c5bca0..281f6d2 100644 --- a/plugins/javascript-typescript/skills/modern-javascript-patterns/SKILL.md +++ b/plugins/javascript-typescript/skills/modern-javascript-patterns/SKILL.md @@ -917,11 +917,3 @@ const first = doubled.next().value; // Only computes first value 6. **Blocking event loop**: Avoid synchronous operations 7. **Memory leaks**: Clean up event listeners and timers 8. **Not handling promise rejections**: Use catch() or try/catch - -## Resources - -- **MDN Web Docs**: https://developer.mozilla.org/en-US/docs/Web/JavaScript -- **JavaScript.info**: https://javascript.info/ -- **You Don't Know JS**: https://github.com/getify/You-Dont-Know-JS -- **Eloquent JavaScript**: https://eloquentjavascript.net/ -- **ES6 Features**: http://es6-features.org/ diff --git a/plugins/javascript-typescript/skills/nodejs-backend-patterns/SKILL.md b/plugins/javascript-typescript/skills/nodejs-backend-patterns/SKILL.md index 70ab552..3a5e237 100644 --- a/plugins/javascript-typescript/skills/nodejs-backend-patterns/SKILL.md +++ b/plugins/javascript-typescript/skills/nodejs-backend-patterns/SKILL.md @@ -1039,10 +1039,3 @@ export class ApiResponse { ## Testing Patterns See `javascript-testing-patterns` skill for comprehensive testing guidance. - -## Resources - -- **Node.js Best Practices**: https://github.com/goldbergyoni/nodebestpractices -- **Express.js Guide**: https://expressjs.com/en/guide/ -- **Fastify Documentation**: https://www.fastify.io/docs/ -- **TypeScript Node Starter**: https://github.com/microsoft/TypeScript-Node-Starter diff --git a/plugins/javascript-typescript/skills/typescript-advanced-types/SKILL.md b/plugins/javascript-typescript/skills/typescript-advanced-types/SKILL.md index 8d64396..7b603df 100644 --- a/plugins/javascript-typescript/skills/typescript-advanced-types/SKILL.md +++ b/plugins/javascript-typescript/skills/typescript-advanced-types/SKILL.md @@ -715,10 +715,3 @@ type ShouldError = ExpectError>; - Cache complex type computations - Limit recursion depth in recursive types - Use build tools to skip type checking in production - -## Resources - -- **TypeScript Handbook**: https://www.typescriptlang.org/docs/handbook/ -- **Type Challenges**: https://github.com/type-challenges/type-challenges -- **TypeScript Deep Dive**: https://basarat.gitbook.io/typescript/ -- **Effective TypeScript**: Book by Dan Vanderkam diff --git a/plugins/kubernetes-operations/skills/helm-chart-scaffolding/SKILL.md b/plugins/kubernetes-operations/skills/helm-chart-scaffolding/SKILL.md index 5230d7b..85bf9f2 100644 --- a/plugins/kubernetes-operations/skills/helm-chart-scaffolding/SKILL.md +++ b/plugins/kubernetes-operations/skills/helm-chart-scaffolding/SKILL.md @@ -553,12 +553,6 @@ helm install my-app ./my-app --dry-run --debug kubectl get events --sort-by='.lastTimestamp' ``` -## Reference Files - -- `assets/Chart.yaml.template` - Chart metadata template -- `assets/values.yaml.template` - Values structure template -- `scripts/validate-chart.sh` - Validation script -- `references/chart-structure.md` - Detailed chart organization ## Related Skills diff --git a/plugins/kubernetes-operations/skills/k8s-security-policies/SKILL.md b/plugins/kubernetes-operations/skills/k8s-security-policies/SKILL.md index a832892..0c9bac1 100644 --- a/plugins/kubernetes-operations/skills/k8s-security-policies/SKILL.md +++ b/plugins/kubernetes-operations/skills/k8s-security-policies/SKILL.md @@ -340,11 +340,6 @@ kubectl auth can-i list pods --as system:serviceaccount:default:my-sa kubectl auth can-i '*' '*' --as system:serviceaccount:default:my-sa ``` -## Reference Files - -- `assets/network-policy-template.yaml` - Network policy examples -- `assets/pod-security-template.yaml` - Pod security policies -- `references/rbac-patterns.md` - RBAC configuration patterns ## Related Skills diff --git a/plugins/llm-application-dev/skills/embedding-strategies/SKILL.md b/plugins/llm-application-dev/skills/embedding-strategies/SKILL.md index 844e962..0edb426 100644 --- a/plugins/llm-application-dev/skills/embedding-strategies/SKILL.md +++ b/plugins/llm-application-dev/skills/embedding-strategies/SKILL.md @@ -598,11 +598,3 @@ def compare_embedding_models( - **Don't skip preprocessing**: Garbage in, garbage out - **Don't over-chunk**: Lose important context - **Don't forget metadata**: Essential for filtering and debugging - -## Resources - -- [Voyage AI Documentation](https://docs.voyageai.com/) -- [OpenAI Embeddings Guide](https://platform.openai.com/docs/guides/embeddings) -- [Sentence Transformers](https://www.sbert.net/) -- [MTEB Benchmark](https://huggingface.co/spaces/mteb/leaderboard) -- [LangChain Embedding Models](https://python.langchain.com/docs/integrations/text_embedding/) diff --git a/plugins/llm-application-dev/skills/hybrid-search-implementation/SKILL.md b/plugins/llm-application-dev/skills/hybrid-search-implementation/SKILL.md index caa4648..5153927 100644 --- a/plugins/llm-application-dev/skills/hybrid-search-implementation/SKILL.md +++ b/plugins/llm-application-dev/skills/hybrid-search-implementation/SKILL.md @@ -562,9 +562,3 @@ class HybridRAGPipeline: - **Don't skip keyword search** - Handles exact matches better - **Don't over-fetch** - Balance recall vs latency - **Don't ignore edge cases** - Empty results, single word queries - -## Resources - -- [RRF Paper](https://plg.uwaterloo.ca/~gvcormac/cormacksigir09-rrf.pdf) -- [Vespa Hybrid Search](https://blog.vespa.ai/improving-text-ranking-with-few-shot-prompting/) -- [Cohere Rerank](https://docs.cohere.com/docs/reranking) diff --git a/plugins/llm-application-dev/skills/langchain-architecture/SKILL.md b/plugins/llm-application-dev/skills/langchain-architecture/SKILL.md index 92f64a6..7452bb5 100644 --- a/plugins/llm-application-dev/skills/langchain-architecture/SKILL.md +++ b/plugins/llm-application-dev/skills/langchain-architecture/SKILL.md @@ -632,35 +632,3 @@ index = pc.Index("my-index") # Create vector store with existing index vectorstore = PineconeVectorStore(index=index, embedding=embeddings) ``` - -## Resources - -- [LangChain Documentation](https://python.langchain.com/docs/) -- [LangGraph Documentation](https://langchain-ai.github.io/langgraph/) -- [LangSmith Platform](https://smith.langchain.com/) -- [LangChain GitHub](https://github.com/langchain-ai/langchain) -- [LangGraph GitHub](https://github.com/langchain-ai/langgraph) - -## Common Pitfalls - -1. **Using Deprecated APIs**: Use LangGraph for agents, not `initialize_agent` -2. **Memory Overflow**: Use checkpointers with TTL for long-running agents -3. **Poor Tool Descriptions**: Clear descriptions help LLM select correct tools -4. **Context Window Exceeded**: Use summarization or sliding window memory -5. **No Error Handling**: Wrap tool functions with try/except -6. **Blocking Operations**: Use async methods (`ainvoke`, `astream`) -7. **Missing Observability**: Always enable LangSmith tracing in production - -## Production Checklist - -- [ ] Use LangGraph StateGraph for agent orchestration -- [ ] Implement async patterns throughout (`ainvoke`, `astream`) -- [ ] Add production checkpointer (PostgreSQL, Redis) -- [ ] Enable LangSmith tracing -- [ ] Implement structured tools with Pydantic schemas -- [ ] Add timeout limits for agent execution -- [ ] Implement rate limiting -- [ ] Add comprehensive error handling -- [ ] Set up health checks -- [ ] Version control prompts and configurations -- [ ] Write integration tests for agent workflows diff --git a/plugins/llm-application-dev/skills/llm-evaluation/SKILL.md b/plugins/llm-application-dev/skills/llm-evaluation/SKILL.md index d29fd28..13066ad 100644 --- a/plugins/llm-application-dev/skills/llm-evaluation/SKILL.md +++ b/plugins/llm-application-dev/skills/llm-evaluation/SKILL.md @@ -664,32 +664,3 @@ class BenchmarkRunner: for metric, scores in results.items() } ``` - -## Resources - -- [LangSmith Evaluation Guide](https://docs.smith.langchain.com/evaluation) -- [RAGAS Framework](https://docs.ragas.io/) -- [DeepEval Library](https://docs.deepeval.com/) -- [Arize Phoenix](https://docs.arize.com/phoenix/) -- [HELM Benchmark](https://crfm.stanford.edu/helm/) - -## Best Practices - -1. **Multiple Metrics**: Use diverse metrics for comprehensive view -2. **Representative Data**: Test on real-world, diverse examples -3. **Baselines**: Always compare against baseline performance -4. **Statistical Rigor**: Use proper statistical tests for comparisons -5. **Continuous Evaluation**: Integrate into CI/CD pipeline -6. **Human Validation**: Combine automated metrics with human judgment -7. **Error Analysis**: Investigate failures to understand weaknesses -8. **Version Control**: Track evaluation results over time - -## Common Pitfalls - -- **Single Metric Obsession**: Optimizing for one metric at the expense of others -- **Small Sample Size**: Drawing conclusions from too few examples -- **Data Contamination**: Testing on training data -- **Ignoring Variance**: Not accounting for statistical uncertainty -- **Metric Mismatch**: Using metrics not aligned with business goals -- **Position Bias**: In pairwise evals, randomize order -- **Overfitting Prompts**: Optimizing for test set instead of real use diff --git a/plugins/llm-application-dev/skills/prompt-engineering-patterns/SKILL.md b/plugins/llm-application-dev/skills/prompt-engineering-patterns/SKILL.md index 016cbe2..7a22910 100644 --- a/plugins/llm-application-dev/skills/prompt-engineering-patterns/SKILL.md +++ b/plugins/llm-application-dev/skills/prompt-engineering-patterns/SKILL.md @@ -471,10 +471,3 @@ Track these KPIs for your prompts: - **Token Usage**: Average tokens per request - **Success Rate**: Percentage of valid, parseable outputs - **User Satisfaction**: Ratings and feedback - -## Resources - -- [Anthropic Prompt Engineering Guide](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering) -- [Claude Prompt Caching](https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching) -- [OpenAI Prompt Engineering](https://platform.openai.com/docs/guides/prompt-engineering) -- [LangChain Prompts](https://python.langchain.com/docs/concepts/prompts/) diff --git a/plugins/llm-application-dev/skills/rag-implementation/SKILL.md b/plugins/llm-application-dev/skills/rag-implementation/SKILL.md index 51037e7..c8a2143 100644 --- a/plugins/llm-application-dev/skills/rag-implementation/SKILL.md +++ b/plugins/llm-application-dev/skills/rag-implementation/SKILL.md @@ -540,31 +540,3 @@ async def evaluate_rag_system( return {k: sum(v) / len(v) for k, v in metrics.items()} ``` - -## Resources - -- [LangChain RAG Tutorial](https://python.langchain.com/docs/tutorials/rag/) -- [LangGraph RAG Examples](https://langchain-ai.github.io/langgraph/tutorials/rag/) -- [Pinecone Best Practices](https://docs.pinecone.io/guides/get-started/overview) -- [Voyage AI Embeddings](https://docs.voyageai.com/) -- [RAG Evaluation Guide](https://docs.ragas.io/) - -## Best Practices - -1. **Chunk Size**: Balance between context (larger) and specificity (smaller) - typically 500-1000 tokens -2. **Overlap**: Use 10-20% overlap to preserve context at boundaries -3. **Metadata**: Include source, page, timestamp for filtering and debugging -4. **Hybrid Search**: Combine semantic and keyword search for best recall -5. **Reranking**: Use cross-encoder reranking for precision-critical applications -6. **Citations**: Always return source documents for transparency -7. **Evaluation**: Continuously test retrieval quality and answer accuracy -8. **Monitoring**: Track retrieval metrics and latency in production - -## Common Issues - -- **Poor Retrieval**: Check embedding quality, chunk size, query formulation -- **Irrelevant Results**: Add metadata filtering, use hybrid search, rerank -- **Missing Information**: Ensure documents are properly indexed, check chunking -- **Slow Queries**: Optimize vector store, use caching, reduce k -- **Hallucinations**: Improve grounding prompt, add verification step -- **Context Too Long**: Use compression or parent document retriever diff --git a/plugins/llm-application-dev/skills/similarity-search-patterns/SKILL.md b/plugins/llm-application-dev/skills/similarity-search-patterns/SKILL.md index aecf406..45daf82 100644 --- a/plugins/llm-application-dev/skills/similarity-search-patterns/SKILL.md +++ b/plugins/llm-application-dev/skills/similarity-search-patterns/SKILL.md @@ -551,10 +551,3 @@ class WeaviateVectorStore: - **Don't over-index** - Start with flat, scale up - **Don't ignore latency** - P99 matters for UX - **Don't forget costs** - Vector storage adds up - -## Resources - -- [Pinecone Docs](https://docs.pinecone.io/) -- [Qdrant Docs](https://qdrant.tech/documentation/) -- [pgvector](https://github.com/pgvector/pgvector) -- [Weaviate Docs](https://weaviate.io/developers/weaviate) diff --git a/plugins/llm-application-dev/skills/vector-index-tuning/SKILL.md b/plugins/llm-application-dev/skills/vector-index-tuning/SKILL.md index 523f895..8265a6f 100644 --- a/plugins/llm-application-dev/skills/vector-index-tuning/SKILL.md +++ b/plugins/llm-application-dev/skills/vector-index-tuning/SKILL.md @@ -515,9 +515,3 @@ def profile_index_build( - **Don't ignore build time** - Index updates have cost - **Don't forget reindexing** - Plan for maintenance - **Don't skip warming** - Cold indexes are slow - -## Resources - -- [HNSW Paper](https://arxiv.org/abs/1603.09320) -- [Faiss Wiki](https://github.com/facebookresearch/faiss/wiki) -- [ANN Benchmarks](https://ann-benchmarks.com/) diff --git a/plugins/observability-monitoring/skills/distributed-tracing/SKILL.md b/plugins/observability-monitoring/skills/distributed-tracing/SKILL.md index 8c453f8..33c1f07 100644 --- a/plugins/observability-monitoring/skills/distributed-tracing/SKILL.md +++ b/plugins/observability-monitoring/skills/distributed-tracing/SKILL.md @@ -441,11 +441,6 @@ def process_request(): - Use batch span processor - Check exporter configuration -## Reference Files - -- `references/jaeger-setup.md` - Jaeger installation -- `references/instrumentation.md` - Instrumentation patterns -- `assets/jaeger-config.yaml.template` - Jaeger configuration ## Related Skills diff --git a/plugins/observability-monitoring/skills/grafana-dashboards/SKILL.md b/plugins/observability-monitoring/skills/grafana-dashboards/SKILL.md index 1f50792..c97df3d 100644 --- a/plugins/observability-monitoring/skills/grafana-dashboards/SKILL.md +++ b/plugins/observability-monitoring/skills/grafana-dashboards/SKILL.md @@ -375,12 +375,6 @@ resource "grafana_folder" "monitoring" { notify: restart grafana ``` -## Reference Files - -- `assets/api-dashboard.json` - API monitoring dashboard -- `assets/infrastructure-dashboard.json` - Infrastructure dashboard -- `assets/database-dashboard.json` - Database monitoring dashboard -- `references/dashboard-design.md` - Dashboard design guide ## Related Skills diff --git a/plugins/observability-monitoring/skills/prometheus-configuration/SKILL.md b/plugins/observability-monitoring/skills/prometheus-configuration/SKILL.md index 5aa8770..954227f 100644 --- a/plugins/observability-monitoring/skills/prometheus-configuration/SKILL.md +++ b/plugins/observability-monitoring/skills/prometheus-configuration/SKILL.md @@ -386,12 +386,6 @@ curl http://localhost:9090/api/v1/status/config curl 'http://localhost:9090/api/v1/query?query=up' ``` -## Reference Files - -- `assets/prometheus.yml.template` - Complete configuration template -- `references/scrape-configs.md` - Scrape configuration patterns -- `references/recording-rules.md` - Recording rule examples -- `scripts/validate-prometheus.sh` - Validation script ## Related Skills diff --git a/plugins/observability-monitoring/skills/slo-implementation/SKILL.md b/plugins/observability-monitoring/skills/slo-implementation/SKILL.md index eebf288..44f1506 100644 --- a/plugins/observability-monitoring/skills/slo-implementation/SKILL.md +++ b/plugins/observability-monitoring/skills/slo-implementation/SKILL.md @@ -326,11 +326,6 @@ rules: 9. **Automate SLO reporting** 10. **Use SLOs for prioritization** -## Reference Files - -- `assets/slo-template.md` - SLO definition template -- `references/slo-definitions.md` - SLO definition patterns -- `references/error-budget.md` - Error budget calculations ## Related Skills diff --git a/plugins/payment-processing/skills/billing-automation/SKILL.md b/plugins/payment-processing/skills/billing-automation/SKILL.md index d40d398..90ba285 100644 --- a/plugins/payment-processing/skills/billing-automation/SKILL.md +++ b/plugins/payment-processing/skills/billing-automation/SKILL.md @@ -535,32 +535,3 @@ class UsageBillingEngine: return charge ``` - -## Resources - -- **references/billing-cycles.md**: Billing cycle management -- **references/dunning-management.md**: Failed payment recovery -- **references/proration.md**: Prorated charge calculations -- **references/tax-calculation.md**: Tax/VAT/GST handling -- **references/invoice-lifecycle.md**: Invoice state management -- **assets/billing-state-machine.yaml**: Billing workflow -- **assets/invoice-template.html**: Invoice templates -- **assets/dunning-policy.yaml**: Dunning configuration - -## Best Practices - -1. **Automate Everything**: Minimize manual intervention -2. **Clear Communication**: Notify customers of billing events -3. **Flexible Retry Logic**: Balance recovery with customer experience -4. **Accurate Proration**: Fair calculation for plan changes -5. **Tax Compliance**: Calculate correct tax for jurisdiction -6. **Audit Trail**: Log all billing events -7. **Graceful Degradation**: Handle edge cases without breaking - -## Common Pitfalls - -- **Incorrect Proration**: Not accounting for partial periods -- **Missing Tax**: Forgetting to add tax to invoices -- **Aggressive Dunning**: Canceling too quickly -- **No Notifications**: Not informing customers of failures -- **Hardcoded Cycles**: Not supporting custom billing dates diff --git a/plugins/payment-processing/skills/paypal-integration/SKILL.md b/plugins/payment-processing/skills/paypal-integration/SKILL.md index de1d704..15ea625 100644 --- a/plugins/payment-processing/skills/paypal-integration/SKILL.md +++ b/plugins/payment-processing/skills/paypal-integration/SKILL.md @@ -448,31 +448,3 @@ def test_payment_flow(): # captured = client.capture_order(order['id']) # assert captured['status'] == 'COMPLETED' ``` - -## Resources - -- **references/express-checkout.md**: Express Checkout implementation guide -- **references/ipn-handling.md**: IPN verification and processing -- **references/refund-workflows.md**: Refund handling patterns -- **references/billing-agreements.md**: Recurring billing setup -- **assets/paypal-client.py**: Production PayPal client -- **assets/ipn-processor.py**: IPN webhook processor -- **assets/recurring-billing.py**: Subscription management - -## Best Practices - -1. **Always Verify IPN**: Never trust IPN without verification -2. **Idempotent Processing**: Handle duplicate IPN notifications -3. **Error Handling**: Implement robust error handling -4. **Logging**: Log all transactions and errors -5. **Test Thoroughly**: Use sandbox extensively -6. **Webhook Backup**: Don't rely solely on client-side callbacks -7. **Currency Handling**: Always specify currency explicitly - -## Common Pitfalls - -- **Not Verifying IPN**: Accepting IPN without verification -- **Duplicate Processing**: Not checking for duplicate transactions -- **Wrong Environment**: Mixing sandbox and production URLs/credentials -- **Missing Webhooks**: Not handling all payment states -- **Hardcoded Values**: Not making configurable for different environments diff --git a/plugins/payment-processing/skills/pci-compliance/SKILL.md b/plugins/payment-processing/skills/pci-compliance/SKILL.md index b838ebe..96d4e38 100644 --- a/plugins/payment-processing/skills/pci-compliance/SKILL.md +++ b/plugins/payment-processing/skills/pci-compliance/SKILL.md @@ -446,35 +446,3 @@ PCI_COMPLIANCE_CHECKLIST = { ] } ``` - -## Resources - -- **references/data-minimization.md**: Never store prohibited data -- **references/tokenization.md**: Tokenization strategies -- **references/encryption.md**: Encryption requirements -- **references/access-control.md**: Role-based access -- **references/audit-logging.md**: Comprehensive logging -- **assets/pci-compliance-checklist.md**: Complete checklist -- **assets/encrypted-storage.py**: Encryption utilities -- **scripts/audit-payment-system.sh**: Compliance audit script - -## Common Violations - -1. **Storing CVV**: Never store card verification codes -2. **Unencrypted PAN**: Card numbers must be encrypted at rest -3. **Weak Encryption**: Use AES-256 or equivalent -4. **No Access Controls**: Restrict who can access cardholder data -5. **Missing Audit Logs**: Must log all access to payment data -6. **Insecure Transmission**: Always use TLS 1.2+ -7. **Default Passwords**: Change all default credentials -8. **No Security Testing**: Regular penetration testing required - -## Reducing PCI Scope - -1. **Use Hosted Payments**: Stripe Checkout, PayPal, etc. -2. **Tokenization**: Replace card data with tokens -3. **Network Segmentation**: Isolate cardholder data environment -4. **Outsource**: Use PCI-compliant payment processors -5. **No Storage**: Never store full card details - -By minimizing systems that touch card data, you reduce compliance burden significantly. diff --git a/plugins/payment-processing/skills/stripe-integration/SKILL.md b/plugins/payment-processing/skills/stripe-integration/SKILL.md index 0d651bb..f8bb33e 100644 --- a/plugins/payment-processing/skills/stripe-integration/SKILL.md +++ b/plugins/payment-processing/skills/stripe-integration/SKILL.md @@ -490,33 +490,3 @@ def test_payment_flow(): assert confirmed.status == 'succeeded' ``` - -## Resources - -- **references/checkout-flows.md**: Detailed checkout implementation -- **references/webhook-handling.md**: Webhook security and processing -- **references/subscription-management.md**: Subscription lifecycle -- **references/customer-management.md**: Customer and payment method handling -- **references/invoice-generation.md**: Invoicing and billing -- **assets/stripe-client.py**: Production-ready Stripe client wrapper -- **assets/webhook-handler.py**: Complete webhook processor -- **assets/checkout-config.json**: Checkout configuration templates - -## Best Practices - -1. **Always Use Webhooks**: Don't rely solely on client-side confirmation -2. **Idempotency**: Handle webhook events idempotently -3. **Error Handling**: Gracefully handle all Stripe errors -4. **Test Mode**: Thoroughly test with test keys before production -5. **Metadata**: Use metadata to link Stripe objects to your database -6. **Monitoring**: Track payment success rates and errors -7. **PCI Compliance**: Never handle raw card data on your server -8. **SCA Ready**: Implement 3D Secure for European payments - -## Common Pitfalls - -- **Not Verifying Webhooks**: Always verify webhook signatures -- **Missing Webhook Events**: Handle all relevant webhook events -- **Hardcoded Amounts**: Use cents/smallest currency unit -- **No Retry Logic**: Implement retries for API calls -- **Ignoring Test Mode**: Test all edge cases with test cards diff --git a/plugins/python-development/skills/async-python-patterns/SKILL.md b/plugins/python-development/skills/async-python-patterns/SKILL.md index 78c8f1e..1f92237 100644 --- a/plugins/python-development/skills/async-python-patterns/SKILL.md +++ b/plugins/python-development/skills/async-python-patterns/SKILL.md @@ -733,25 +733,3 @@ async def test_with_timeout(): with pytest.raises(asyncio.TimeoutError): await asyncio.wait_for(slow_operation(5), timeout=1.0) ``` - -## Resources - -- **Python asyncio documentation**: https://docs.python.org/3/library/asyncio.html -- **aiohttp**: Async HTTP client/server -- **FastAPI**: Modern async web framework -- **asyncpg**: Async PostgreSQL driver -- **motor**: Async MongoDB driver - -## Best Practices Summary - -1. **Use asyncio.run()** for entry point (Python 3.7+) -2. **Always await coroutines** to execute them -3. **Limit concurrency with semaphores** - unbounded `gather()` can exhaust resources -4. **Implement proper error handling** with try/except -5. **Use timeouts** to prevent hanging operations -6. **Pool connections** for better performance -7. **Never block the event loop** - use `asyncio.to_thread()` for sync code -8. **Use semaphores** for rate limiting external API calls -9. **Handle task cancellation** properly - always re-raise `CancelledError` -10. **Test async code** with pytest-asyncio -11. **Stay consistent** - fully sync or fully async, avoid mixing diff --git a/plugins/python-development/skills/python-packaging/SKILL.md b/plugins/python-development/skills/python-packaging/SKILL.md index 732e6e2..6a3f6aa 100644 --- a/plugins/python-development/skills/python-packaging/SKILL.md +++ b/plugins/python-development/skills/python-packaging/SKILL.md @@ -864,25 +864,3 @@ recursive-exclude * *.py[co] - [ ] GitHub repository linked - [ ] Tested on TestPyPI first - [ ] Git tag created for release - -## Resources - -- **Python Packaging Guide**: https://packaging.python.org/ -- **PyPI**: https://pypi.org/ -- **TestPyPI**: https://test.pypi.org/ -- **setuptools documentation**: https://setuptools.pypa.io/ -- **build**: https://pypa-build.readthedocs.io/ -- **twine**: https://twine.readthedocs.io/ - -## Best Practices Summary - -1. **Use src/ layout** for cleaner package structure -2. **Use pyproject.toml** for modern packaging -3. **Pin build dependencies** in build-system.requires -4. **Version appropriately** with semantic versioning -5. **Include all metadata** (classifiers, URLs, etc.) -6. **Test installation** in clean environments -7. **Use TestPyPI** before publishing to PyPI -8. **Document thoroughly** with README and docstrings -9. **Include LICENSE** file -10. **Automate publishing** with CI/CD diff --git a/plugins/python-development/skills/python-performance-optimization/SKILL.md b/plugins/python-development/skills/python-performance-optimization/SKILL.md index 68b233e..31b820c 100644 --- a/plugins/python-development/skills/python-performance-optimization/SKILL.md +++ b/plugins/python-development/skills/python-performance-optimization/SKILL.md @@ -849,26 +849,3 @@ def test_map_function(benchmark): - Ignoring algorithmic complexity - Over-optimizing rare code paths - Not considering memory usage - -## Resources - -- **cProfile**: Built-in CPU profiler -- **memory_profiler**: Memory usage profiling -- **line_profiler**: Line-by-line profiling -- **py-spy**: Sampling profiler for production -- **NumPy**: High-performance numerical computing -- **Cython**: Compile Python to C -- **PyPy**: Alternative Python interpreter with JIT - -## Performance Checklist - -- [ ] Profiled code to identify bottlenecks -- [ ] Used appropriate data structures -- [ ] Implemented caching where beneficial -- [ ] Optimized database queries -- [ ] Used generators for large datasets -- [ ] Considered multiprocessing for CPU-bound tasks -- [ ] Used async I/O for I/O-bound tasks -- [ ] Minimized function call overhead in hot loops -- [ ] Checked for memory leaks -- [ ] Benchmarked before and after optimization diff --git a/plugins/python-development/skills/python-testing-patterns/SKILL.md b/plugins/python-development/skills/python-testing-patterns/SKILL.md index 6693894..92a4282 100644 --- a/plugins/python-development/skills/python-testing-patterns/SKILL.md +++ b/plugins/python-development/skills/python-testing-patterns/SKILL.md @@ -1026,25 +1026,3 @@ exclude_lines = [ "raise NotImplementedError", ] ``` - -## Resources - -- **pytest documentation**: https://docs.pytest.org/ -- **unittest.mock**: https://docs.python.org/3/library/unittest.mock.html -- **hypothesis**: Property-based testing -- **pytest-asyncio**: Testing async code -- **pytest-cov**: Coverage reporting -- **pytest-mock**: pytest wrapper for mock - -## Best Practices Summary - -1. **Write tests first** (TDD) or alongside code -2. **One assertion per test** when possible -3. **Use descriptive test names** that explain behavior -4. **Keep tests independent** and isolated -5. **Use fixtures** for setup and teardown -6. **Mock external dependencies** appropriately -7. **Parametrize tests** to reduce duplication -8. **Test edge cases** and error conditions -9. **Measure coverage** but focus on quality -10. **Run tests in CI/CD** on every commit diff --git a/plugins/python-development/skills/uv-package-manager/SKILL.md b/plugins/python-development/skills/uv-package-manager/SKILL.md index e3cb4c5..d485be8 100644 --- a/plugins/python-development/skills/uv-package-manager/SKILL.md +++ b/plugins/python-development/skills/uv-package-manager/SKILL.md @@ -811,24 +811,3 @@ uv cache clean # Clear cache uv cache dir # Show cache location uv --version # Show version ``` - -## Resources - -- **Official documentation**: https://docs.astral.sh/uv/ -- **GitHub repository**: https://github.com/astral-sh/uv -- **Astral blog**: https://astral.sh/blog -- **Migration guides**: https://docs.astral.sh/uv/guides/ -- **Comparison with other tools**: https://docs.astral.sh/uv/pip/compatibility/ - -## Best Practices Summary - -1. **Use uv for all new projects** - Start with `uv init` -2. **Commit lockfiles** - Ensure reproducible builds -3. **Pin Python versions** - Use .python-version -4. **Use uv run** - Avoid manual venv activation -5. **Leverage caching** - Let uv manage global cache -6. **Use --frozen in CI** - Exact reproduction -7. **Keep uv updated** - Fast-moving project -8. **Use workspaces** - For monorepo projects -9. **Export for compatibility** - Generate requirements.txt when needed -10. **Read the docs** - uv is feature-rich and evolving diff --git a/plugins/quantitative-trading/skills/backtesting-frameworks/SKILL.md b/plugins/quantitative-trading/skills/backtesting-frameworks/SKILL.md index 6cbe84c..675674d 100644 --- a/plugins/quantitative-trading/skills/backtesting-frameworks/SKILL.md +++ b/plugins/quantitative-trading/skills/backtesting-frameworks/SKILL.md @@ -655,9 +655,3 @@ def calculate_metrics(returns: pd.Series, rf_rate: float = 0.02) -> Dict[str, fl - **Don't use adjusted data carelessly** - Understand adjustments - **Don't optimize on full history** - Reserve test set - **Don't ignore capacity** - Market impact matters - -## Resources - -- [Advances in Financial Machine Learning (Marcos López de Prado)](https://www.amazon.com/Advances-Financial-Machine-Learning-Marcos/dp/1119482089) -- [Quantitative Trading (Ernest Chan)](https://www.amazon.com/Quantitative-Trading-Build-Algorithmic-Business/dp/1119800064) -- [Backtrader Documentation](https://www.backtrader.com/docu/) diff --git a/plugins/quantitative-trading/skills/risk-metrics-calculation/SKILL.md b/plugins/quantitative-trading/skills/risk-metrics-calculation/SKILL.md index fd049f7..35035c7 100644 --- a/plugins/quantitative-trading/skills/risk-metrics-calculation/SKILL.md +++ b/plugins/quantitative-trading/skills/risk-metrics-calculation/SKILL.md @@ -549,9 +549,3 @@ for metric, value in summary.items(): - **Don't ignore correlation** - Increases in stress - **Don't use short lookbacks** - Miss regime changes - **Don't forget transaction costs** - Affects realized risk - -## Resources - -- [Risk Management and Financial Institutions (John Hull)](https://www.amazon.com/Risk-Management-Financial-Institutions-5th/dp/1119448115) -- [Quantitative Risk Management (McNeil, Frey, Embrechts)](https://www.amazon.com/Quantitative-Risk-Management-Techniques-Princeton/dp/0691166277) -- [pyfolio Documentation](https://quantopian.github.io/pyfolio/) diff --git a/plugins/security-scanning/skills/attack-tree-construction/SKILL.md b/plugins/security-scanning/skills/attack-tree-construction/SKILL.md index 8ae8729..09b03f4 100644 --- a/plugins/security-scanning/skills/attack-tree-construction/SKILL.md +++ b/plugins/security-scanning/skills/attack-tree-construction/SKILL.md @@ -679,9 +679,3 @@ class AttackPathAnalyzer: - **Don't forget insider threats** - Not all attackers are external - **Don't skip mitigations** - Trees are for defense planning - **Don't make it static** - Threat landscape evolves - -## Resources - -- [Attack Trees by Bruce Schneier](https://www.schneier.com/academic/archives/1999/12/attack_trees.html) -- [MITRE ATT&CK Framework](https://attack.mitre.org/) -- [OWASP Attack Surface Analysis](https://owasp.org/www-community/controls/Attack_Surface_Analysis_Cheat_Sheet) diff --git a/plugins/security-scanning/skills/security-requirement-extraction/SKILL.md b/plugins/security-scanning/skills/security-requirement-extraction/SKILL.md index 9051b81..ad570f9 100644 --- a/plugins/security-scanning/skills/security-requirement-extraction/SKILL.md +++ b/plugins/security-scanning/skills/security-requirement-extraction/SKILL.md @@ -671,9 +671,3 @@ This epic covers all security requirements related to {domain.value.replace('_', - **Don't ignore priorities** - Not all requirements are equal - **Don't forget testability** - If you can't test it, you can't verify it - **Don't work in isolation** - Involve stakeholders - -## Resources - -- [OWASP ASVS](https://owasp.org/www-project-application-security-verification-standard/) -- [NIST SP 800-53](https://csrc.nist.gov/publications/detail/sp/800-53/rev-5/final) -- [Security User Stories](https://www.oreilly.com/library/view/agile-application-security/9781491938836/) diff --git a/plugins/security-scanning/skills/stride-analysis-patterns/SKILL.md b/plugins/security-scanning/skills/stride-analysis-patterns/SKILL.md index cb69854..13963aa 100644 --- a/plugins/security-scanning/skills/stride-analysis-patterns/SKILL.md +++ b/plugins/security-scanning/skills/stride-analysis-patterns/SKILL.md @@ -656,9 +656,3 @@ class StridePerInteraction: - **Don't work in isolation** - Collaborative modeling is better - **Don't ignore low-probability** - High-impact threats matter - **Don't stop at identification** - Follow through with mitigations - -## Resources - -- [Microsoft STRIDE Documentation](https://docs.microsoft.com/en-us/azure/security/develop/threat-modeling-tool-threats) -- [OWASP Threat Modeling](https://owasp.org/www-community/Threat_Modeling) -- [Threat Modeling: Designing for Security](https://www.wiley.com/en-us/Threat+Modeling%3A+Designing+for+Security-p-9781118809990) diff --git a/plugins/security-scanning/skills/threat-mitigation-mapping/SKILL.md b/plugins/security-scanning/skills/threat-mitigation-mapping/SKILL.md index ba28c2b..b6a145e 100644 --- a/plugins/security-scanning/skills/threat-mitigation-mapping/SKILL.md +++ b/plugins/security-scanning/skills/threat-mitigation-mapping/SKILL.md @@ -739,9 +739,3 @@ class ControlTester: - **Don't skip testing** - Untested controls may fail - **Don't set and forget** - Continuous improvement - **Don't ignore people/process** - Technology alone isn't enough - -## Resources - -- [NIST Cybersecurity Framework](https://www.nist.gov/cyberframework) -- [CIS Controls](https://www.cisecurity.org/controls) -- [MITRE D3FEND](https://d3fend.mitre.org/) diff --git a/plugins/shell-scripting/skills/bash-defensive-patterns/SKILL.md b/plugins/shell-scripting/skills/bash-defensive-patterns/SKILL.md index 5540984..e3ad639 100644 --- a/plugins/shell-scripting/skills/bash-defensive-patterns/SKILL.md +++ b/plugins/shell-scripting/skills/bash-defensive-patterns/SKILL.md @@ -531,9 +531,3 @@ check_dependencies 12. **Test error paths** - Ensure error handling works correctly 13. **Use `command -v`** - Safer than `which` for checking executables 14. **Prefer printf over echo** - More predictable across systems - -## Resources - -- **Bash Strict Mode**: http://redsymbol.net/articles/unofficial-bash-strict-mode/ -- **Google Shell Style Guide**: https://google.github.io/styleguide/shellguide.html -- **Defensive BASH Programming**: https://www.lifepipe.net/ diff --git a/plugins/shell-scripting/skills/bats-testing-patterns/SKILL.md b/plugins/shell-scripting/skills/bats-testing-patterns/SKILL.md index e0f7135..6c438af 100644 --- a/plugins/shell-scripting/skills/bats-testing-patterns/SKILL.md +++ b/plugins/shell-scripting/skills/bats-testing-patterns/SKILL.md @@ -622,10 +622,3 @@ coverage: test 8. **Test across shell dialects** - Ensure portability 9. **Keep tests fast** - Run in parallel when possible 10. **Document complex test setup** - Explain unusual patterns - -## Resources - -- **Bats GitHub**: https://github.com/bats-core/bats-core -- **Bats Documentation**: https://bats-core.readthedocs.io/ -- **TAP Protocol**: https://testanything.org/ -- **Test-Driven Development**: https://en.wikipedia.org/wiki/Test-driven_development diff --git a/plugins/shell-scripting/skills/shellcheck-configuration/SKILL.md b/plugins/shell-scripting/skills/shellcheck-configuration/SKILL.md index 15fe3dd..13e0d8b 100644 --- a/plugins/shell-scripting/skills/shellcheck-configuration/SKILL.md +++ b/plugins/shell-scripting/skills/shellcheck-configuration/SKILL.md @@ -448,9 +448,3 @@ shellcheck --format=quiet script.sh 6. **Update regularly** - Keep ShellCheck current for new checks 7. **Use pre-commit hooks** - Catch issues locally before pushing 8. **Integrate with editors** - Get real-time feedback during development - -## Resources - -- **ShellCheck GitHub**: https://github.com/koalaman/shellcheck -- **ShellCheck Wiki**: https://www.shellcheck.net/wiki/ -- **Error Code Reference**: https://www.shellcheck.net/ diff --git a/plugins/startup-business-analyst/skills/competitive-landscape/SKILL.md b/plugins/startup-business-analyst/skills/competitive-landscape/SKILL.md index 3fe4609..15ebde3 100644 --- a/plugins/startup-business-analyst/skills/competitive-landscape/SKILL.md +++ b/plugins/startup-business-analyst/skills/competitive-landscape/SKILL.md @@ -499,17 +499,6 @@ If "no" to any, it's not a sustainable advantage. - Major strategy reassessment - Market trends analysis -## Additional Resources - -### Reference Files - -- **`references/frameworks-deep-dive.md`** - Detailed application of each framework with worksheets -- **`references/intel-sources.md`** - Comprehensive list of competitive intelligence sources - -### Example Files - -- **`examples/competitor-analysis.md`** - Complete competitive analysis for a SaaS startup -- **`examples/positioning-workshop.md`** - Step-by-step positioning development process ## Quick Start @@ -523,5 +512,3 @@ To analyze competitive landscape: 6. **Analyze pricing** - Where do you fit? 7. **Assess advantages** - What's defensible? 8. **Develop strategy** - How to win - -For detailed frameworks and examples, see `references/` and `examples/`. diff --git a/plugins/startup-business-analyst/skills/market-sizing-analysis/SKILL.md b/plugins/startup-business-analyst/skills/market-sizing-analysis/SKILL.md index 4b18f32..79e970f 100644 --- a/plugins/startup-business-analyst/skills/market-sizing-analysis/SKILL.md +++ b/plugins/startup-business-analyst/skills/market-sizing-analysis/SKILL.md @@ -414,25 +414,6 @@ TAM = Total Target Companies × Average Deal Size × Deals per Year - Consider competitive intensity - Factor in switching costs and barriers -## Additional Resources - -### Reference Files - -For detailed methodologies and frameworks: - -- **`references/methodology-deep-dive.md`** - Comprehensive guide to each methodology with step-by-step worksheets -- **`references/data-sources.md`** - Curated list of market research sources, databases, and tools -- **`references/industry-templates.md`** - Specific templates for SaaS, marketplace, consumer, B2B, and fintech markets - -### Example Files - -Working examples with complete calculations: - -- **`examples/saas-market-sizing.md`** - Complete TAM/SAM/SOM for a B2B SaaS product -- **`examples/marketplace-sizing.md`** - Marketplace platform market opportunity calculation -- **`examples/value-theory-example.md`** - Value-based market sizing for disruptive innovation - -Use these examples as templates for your own market sizing analysis. Each includes real numbers, data sources, and assumptions documented clearly. ## Quick Start @@ -447,5 +428,3 @@ To perform market sizing analysis: 7. **Validate** - Cross-check with alternative methods 8. **Document** - Show methodology, sources, assumptions 9. **Present** - Structure for audience (investors, strategy, operations) - -For detailed step-by-step guidance on each methodology, reference the files in `references/` directory. For complete worked examples, see `examples/` directory. diff --git a/plugins/startup-business-analyst/skills/startup-financial-modeling/SKILL.md b/plugins/startup-business-analyst/skills/startup-financial-modeling/SKILL.md index b96fab5..b0875c9 100644 --- a/plugins/startup-business-analyst/skills/startup-financial-modeling/SKILL.md +++ b/plugins/startup-business-analyst/skills/startup-financial-modeling/SKILL.md @@ -459,23 +459,6 @@ Compare key metrics to similar companies at similar stage. **Investor Feedback:** Share model with advisors or investors for feedback on assumptions. -## Additional Resources - -### Reference Files - -For detailed model structures and advanced techniques: - -- **`references/model-templates.md`** - Complete financial model templates by business model -- **`references/unit-economics.md`** - Deep dive on CAC, LTV, payback, and efficiency metrics -- **`references/fundraising-scenarios.md`** - Modeling funding rounds and dilution - -### Example Files - -Working financial models with formulas: - -- **`examples/saas-financial-model.md`** - Complete 3-year SaaS model with cohort analysis -- **`examples/marketplace-model.md`** - Marketplace GMV and take rate projections -- **`examples/scenario-analysis.md`** - Three-scenario framework with sensitivities ## Quick Start @@ -490,5 +473,3 @@ To create a startup financial model: 7. **Create scenarios** - Conservative, base, optimistic 8. **Validate assumptions** - Sanity check and benchmark 9. **Integrate fundraising** - Model funding rounds and milestones - -For complete templates and formulas, reference the `references/` and `examples/` files. diff --git a/plugins/startup-business-analyst/skills/startup-metrics-framework/SKILL.md b/plugins/startup-business-analyst/skills/startup-metrics-framework/SKILL.md index 383a1c8..b9151a1 100644 --- a/plugins/startup-business-analyst/skills/startup-metrics-framework/SKILL.md +++ b/plugins/startup-business-analyst/skills/startup-metrics-framework/SKILL.md @@ -534,19 +534,6 @@ Burn: $180K/mo | Runway: 18 months - Growth rate or trend - Context (target, benchmark) -## Additional Resources - -### Reference Files - -- **`references/metric-definitions.md`** - Complete definitions and formulas for 50+ metrics -- **`references/benchmarks-by-stage.md`** - Target ranges for each metric by company stage -- **`references/calculation-examples.md`** - Step-by-step calculation examples - -### Example Files - -- **`examples/saas-metrics-dashboard.md`** - Complete metrics suite for B2B SaaS company -- **`examples/marketplace-metrics.md`** - Marketplace-specific metrics with examples -- **`examples/investor-metrics-deck.md`** - How to present metrics for fundraising ## Quick Start @@ -560,5 +547,3 @@ To implement startup metrics framework: 6. **Review regularly** - Weekly for core metrics 7. **Share with team** - Align on goals and progress 8. **Update investors** - Monthly/quarterly reporting - -For detailed definitions, benchmarks, and examples, see `references/` and `examples/`. diff --git a/plugins/startup-business-analyst/skills/team-composition-analysis/SKILL.md b/plugins/startup-business-analyst/skills/team-composition-analysis/SKILL.md index 1d40332..73e1dd7 100644 --- a/plugins/startup-business-analyst/skills/team-composition-analysis/SKILL.md +++ b/plugins/startup-business-analyst/skills/team-composition-analysis/SKILL.md @@ -409,17 +409,6 @@ Example: Total: $1.1M ``` -## Additional Resources - -### Reference Files - -- **`references/compensation-benchmarks.md`** - Detailed salary data by role, level, and location -- **`references/equity-calculator.md`** - Equity sizing formulas and dilution scenarios - -### Example Files - -- **`examples/seed-stage-hiring-plan.md`** - Complete hiring plan for seed-stage SaaS company -- **`examples/org-chart-evolution.md`** - Organizational design from 5 to 50 people ## Quick Start @@ -433,5 +422,3 @@ To plan team composition: 6. **Calculate budget** - Fully-loaded cost × headcount 7. **Design org chart** - Reporting structure and span of control 8. **Allocate equity** - Fair allocation that preserves pool - -For detailed compensation benchmarks and hiring plan templates, see `references/` and `examples/`. diff --git a/plugins/systems-programming/skills/go-concurrency-patterns/SKILL.md b/plugins/systems-programming/skills/go-concurrency-patterns/SKILL.md index 1e35514..bb6ad39 100644 --- a/plugins/systems-programming/skills/go-concurrency-patterns/SKILL.md +++ b/plugins/systems-programming/skills/go-concurrency-patterns/SKILL.md @@ -649,9 +649,3 @@ go run -race main.go - **Don't use shared memory** - Unless necessary - **Don't ignore context cancellation** - Check ctx.Done() - **Don't use time.Sleep for sync** - Use proper primitives - -## Resources - -- [Go Concurrency Patterns](https://go.dev/blog/pipelines) -- [Effective Go - Concurrency](https://go.dev/doc/effective_go#concurrency) -- [Go by Example - Goroutines](https://gobyexample.com/goroutines) diff --git a/plugins/systems-programming/skills/memory-safety-patterns/SKILL.md b/plugins/systems-programming/skills/memory-safety-patterns/SKILL.md index f1467e5..b8aea29 100644 --- a/plugins/systems-programming/skills/memory-safety-patterns/SKILL.md +++ b/plugins/systems-programming/skills/memory-safety-patterns/SKILL.md @@ -598,9 +598,3 @@ cargo +nightly miri run # ThreadSanitizer clang++ -fsanitize=thread -g source.cpp ``` - -## Resources - -- [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/) -- [Rust Ownership](https://doc.rust-lang.org/book/ch04-00-understanding-ownership.html) -- [AddressSanitizer](https://clang.llvm.org/docs/AddressSanitizer.html) diff --git a/plugins/systems-programming/skills/rust-async-patterns/SKILL.md b/plugins/systems-programming/skills/rust-async-patterns/SKILL.md index 90ab101..a601219 100644 --- a/plugins/systems-programming/skills/rust-async-patterns/SKILL.md +++ b/plugins/systems-programming/skills/rust-async-patterns/SKILL.md @@ -511,9 +511,3 @@ tokio::spawn(async move { - **Don't spawn unboundedly** - Use semaphores for limits - **Don't ignore errors** - Propagate with `?` or log - **Don't forget Send bounds** - For spawned futures - -## Resources - -- [Tokio Tutorial](https://tokio.rs/tokio/tutorial) -- [Async Book](https://rust-lang.github.io/async-book/) -- [Tokio Console](https://github.com/tokio-rs/console) diff --git a/plugins/ui-design/skills/accessibility-compliance/SKILL.md b/plugins/ui-design/skills/accessibility-compliance/SKILL.md index 5b31cff..e55727f 100644 --- a/plugins/ui-design/skills/accessibility-compliance/SKILL.md +++ b/plugins/ui-design/skills/accessibility-compliance/SKILL.md @@ -410,11 +410,3 @@ const CONTRAST_REQUIREMENTS = { - **Automated**: axe DevTools, WAVE, Lighthouse - **Manual**: VoiceOver (macOS/iOS), NVDA/JAWS (Windows), TalkBack (Android) - **Simulators**: NoCoffee (vision), Silktide (various disabilities) - -## Resources - -- [WCAG 2.2 Guidelines](https://www.w3.org/WAI/WCAG22/quickref/) -- [WAI-ARIA Authoring Practices](https://www.w3.org/WAI/ARIA/apg/) -- [A11y Project Checklist](https://www.a11yproject.com/checklist/) -- [Inclusive Components](https://inclusive-components.design/) -- [Deque University](https://dequeuniversity.com/) diff --git a/plugins/ui-design/skills/design-system-patterns/SKILL.md b/plugins/ui-design/skills/design-system-patterns/SKILL.md index 9c56825..264a155 100644 --- a/plugins/ui-design/skills/design-system-patterns/SKILL.md +++ b/plugins/ui-design/skills/design-system-patterns/SKILL.md @@ -327,11 +327,3 @@ module.exports = { - **Hardcoded Values**: Using raw values instead of tokens - **Circular References**: Tokens referencing each other in loops - **Platform Gaps**: Tokens missing for some platforms (web but not mobile) - -## Resources - -- [Style Dictionary Documentation](https://amzn.github.io/style-dictionary/) -- [Tokens Studio for Figma](https://tokens.studio/) -- [Design Tokens W3C Spec](https://design-tokens.github.io/community-group/format/) -- [Radix UI Themes](https://www.radix-ui.com/themes) -- [shadcn/ui Theming](https://ui.shadcn.com/docs/theming) diff --git a/plugins/ui-design/skills/interaction-design/SKILL.md b/plugins/ui-design/skills/interaction-design/SKILL.md index cea352e..47338f0 100644 --- a/plugins/ui-design/skills/interaction-design/SKILL.md +++ b/plugins/ui-design/skills/interaction-design/SKILL.md @@ -318,10 +318,3 @@ function AnimatedComponent() { - **Blocking Interactions**: Never prevent user input during animations - **Memory Leaks**: Clean up animation listeners on unmount - **Flash of Content**: Use `will-change` sparingly for optimization - -## Resources - -- [Framer Motion Documentation](https://www.framer.com/motion/) -- [CSS Animation Guide](https://web.dev/animations-guide/) -- [Material Design Motion](https://m3.material.io/styles/motion/overview) -- [GSAP Animation Library](https://greensock.com/gsap/) diff --git a/plugins/ui-design/skills/mobile-android-design/SKILL.md b/plugins/ui-design/skills/mobile-android-design/SKILL.md index 316f16b..4df6723 100644 --- a/plugins/ui-design/skills/mobile-android-design/SKILL.md +++ b/plugins/ui-design/skills/mobile-android-design/SKILL.md @@ -431,10 +431,3 @@ fun ItemListCard( - **Theme Leaks**: Ensure `MaterialTheme` wraps all composables - **Navigation Crashes**: Handle back press and deep links properly - **Memory Leaks**: Cancel coroutines in `DisposableEffect` - -## Resources - -- [Material Design 3](https://m3.material.io/) -- [Jetpack Compose Documentation](https://developer.android.com/jetpack/compose) -- [Compose Samples](https://github.com/android/compose-samples) -- [Material 3 Compose](https://developer.android.com/jetpack/compose/designsystems/material3) diff --git a/plugins/ui-design/skills/mobile-ios-design/SKILL.md b/plugins/ui-design/skills/mobile-ios-design/SKILL.md index 2e7d828..931c506 100644 --- a/plugins/ui-design/skills/mobile-ios-design/SKILL.md +++ b/plugins/ui-design/skills/mobile-ios-design/SKILL.md @@ -257,10 +257,3 @@ struct FeatureCard: View { - **Dark Mode Problems**: Avoid hardcoded colors; use semantic or asset catalog colors - **Accessibility Failures**: Test with VoiceOver enabled - **Memory Leaks**: Watch for strong reference cycles in closures - -## Resources - -- [Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/) -- [SwiftUI Documentation](https://developer.apple.com/documentation/swiftui) -- [SF Symbols App](https://developer.apple.com/sf-symbols/) -- [WWDC SwiftUI Sessions](https://developer.apple.com/videos/swiftui/) diff --git a/plugins/ui-design/skills/react-native-design/SKILL.md b/plugins/ui-design/skills/react-native-design/SKILL.md index f4b0a82..6aebbc0 100644 --- a/plugins/ui-design/skills/react-native-design/SKILL.md +++ b/plugins/ui-design/skills/react-native-design/SKILL.md @@ -430,11 +430,3 @@ const styles = StyleSheet.create({ - **Memory Leaks**: Cancel animations and cleanup in useEffect - **Font Loading**: Use `expo-font` or `react-native-asset` for custom fonts - **Safe Area Issues**: Test on notched devices (iPhone, Android with cutouts) - -## Resources - -- [React Native Documentation](https://reactnative.dev/) -- [React Navigation](https://reactnavigation.org/) -- [Reanimated Documentation](https://docs.swmansion.com/react-native-reanimated/) -- [Gesture Handler](https://docs.swmansion.com/react-native-gesture-handler/) -- [Expo Documentation](https://docs.expo.dev/) diff --git a/plugins/ui-design/skills/responsive-design/SKILL.md b/plugins/ui-design/skills/responsive-design/SKILL.md index f4232ea..038da96 100644 --- a/plugins/ui-design/skills/responsive-design/SKILL.md +++ b/plugins/ui-design/skills/responsive-design/SKILL.md @@ -514,11 +514,3 @@ function ResponsiveDataTable({ data, columns }) { - **Touch Targets**: Buttons too small to tap accurately - **Aspect Ratio**: Images squishing or stretching - **Z-Index Stacking**: Overlays breaking on different screens - -## Resources - -- [CSS Container Queries](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_container_queries) -- [Utopia Fluid Type Calculator](https://utopia.fyi/type/calculator/) -- [Every Layout](https://every-layout.dev/) -- [Responsive Images Guide](https://web.dev/responsive-images/) -- [CSS Grid Garden](https://cssgridgarden.com/) diff --git a/plugins/ui-design/skills/visual-design-foundations/SKILL.md b/plugins/ui-design/skills/visual-design-foundations/SKILL.md index d3e452e..029e7a9 100644 --- a/plugins/ui-design/skills/visual-design-foundations/SKILL.md +++ b/plugins/ui-design/skills/visual-design-foundations/SKILL.md @@ -316,11 +316,3 @@ export function Icon({ name, size = "md", className }: IconProps) { - **Magic Numbers**: Arbitrary values instead of tokens - **Missing States**: Forgetting hover, focus, disabled - **No Dark Mode Plan**: Retrofitting is harder than planning - -## Resources - -- [Tailwind CSS Documentation](https://tailwindcss.com/docs) -- [Type Scale Calculator](https://typescale.com/) -- [Contrast Checker](https://webaim.org/resources/contrastchecker/) -- [Material Design Color System](https://m3.material.io/styles/color/overview) -- [Radix Colors](https://www.radix-ui.com/colors) diff --git a/plugins/ui-design/skills/web-component-design/SKILL.md b/plugins/ui-design/skills/web-component-design/SKILL.md index fb3abc3..f118d3e 100644 --- a/plugins/ui-design/skills/web-component-design/SKILL.md +++ b/plugins/ui-design/skills/web-component-design/SKILL.md @@ -269,11 +269,3 @@ const isActive = computed(() => tabs?.activeTab.value === props.id); - **Re-render Cascades**: Profile with React DevTools, memo appropriately - **Accessibility Gaps**: Test with screen readers and keyboard navigation - **Bundle Size**: Tree-shake unused component variants - -## Resources - -- [React Component Patterns](https://reactpatterns.com/) -- [Vue Composition API Guide](https://vuejs.org/guide/reusability/composables.html) -- [Svelte Component Documentation](https://svelte.dev/docs/svelte-components) -- [Radix UI Primitives](https://www.radix-ui.com/primitives) -- [shadcn/ui Components](https://ui.shadcn.com/)