From 47a5dbc3f9c2661c6afb13638f80d4a4d4449040 Mon Sep 17 00:00:00 2001 From: Seth Hobson Date: Sat, 7 Mar 2026 10:53:17 -0500 Subject: [PATCH] fix(skills): remove phantom resource references and fix CoC links (#447) Remove references to non-existent resource files (references/, assets/, scripts/, examples/) from 115 skill SKILL.md files. These sections pointed to directories and files that were never created, causing confusion when users install skills. Also fix broken Code of Conduct links in issue templates to use absolute GitHub URLs instead of relative paths that 404. --- .github/ISSUE_TEMPLATE/bug_report.yml | 2 +- .github/ISSUE_TEMPLATE/feature_request.yml | 2 +- .github/ISSUE_TEMPLATE/new_subagent.yml | 2 +- .../skills/screen-reader-testing/SKILL.md | 7 - .../skills/wcag-audit-patterns/SKILL.md | 7 - .../skills/fastapi-templates/SKILL.md | 27 --- .../skills/api-design-principles/SKILL.md | 10 - .../skills/architecture-patterns/SKILL.md | 28 --- .../skills/cqrs-implementation/SKILL.md | 5 - .../skills/event-store-design/SKILL.md | 6 - .../skills/microservices-patterns/SKILL.md | 31 ---- .../skills/projection-patterns/SKILL.md | 5 - .../skills/saga-orchestration/SKILL.md | 5 - .../skills/defi-protocol-templates/SKILL.md | 30 --- .../skills/nft-standards/SKILL.md | 28 --- .../skills/solidity-security/SKILL.md | 29 --- .../skills/web3-testing/SKILL.md | 25 --- .../skills/data-storytelling/SKILL.md | 6 - .../skills/kpi-dashboard-design/SKILL.md | 6 - .../deployment-pipeline-design/SKILL.md | 4 - .../skills/github-actions-templates/SKILL.md | 6 - .../skills/gitlab-ci-patterns/SKILL.md | 4 - .../skills/secrets-management/SKILL.md | 4 - .../skills/cost-optimization/SKILL.md | 4 - .../skills/hybrid-cloud-networking/SKILL.md | 4 - .../skills/istio-traffic-management/SKILL.md | 6 - .../skills/linkerd-patterns/SKILL.md | 6 - .../skills/mtls-configuration/SKILL.md | 7 - .../skills/multi-cloud-architecture/SKILL.md | 4 - .../service-mesh-observability/SKILL.md | 7 - .../skills/terraform-module-library/SKILL.md | 7 - .../skills/airflow-dag-patterns/SKILL.md | 6 - .../skills/data-quality-frameworks/SKILL.md | 7 - .../dbt-transformation-patterns/SKILL.md | 7 - .../skills/spark-optimization/SKILL.md | 6 - .../auth-implementation-patterns/SKILL.md | 9 - .../skills/bazel-build-optimization/SKILL.md | 6 - .../skills/code-review-excellence/SKILL.md | 9 - .../skills/debugging-strategies/SKILL.md | 9 - .../skills/e2e-testing-patterns/SKILL.md | 9 - .../skills/error-handling-patterns/SKILL.md | 9 - .../skills/git-advanced-workflows/SKILL.md | 9 - .../skills/monorepo-management/SKILL.md | 9 - .../skills/nx-workspace-patterns/SKILL.md | 6 - .../skills/sql-optimization-patterns/SKILL.md | 10 - .../skills/turborepo-caching/SKILL.md | 6 - .../architecture-decision-records/SKILL.md | 7 - .../skills/changelog-automation/SKILL.md | 8 - .../skills/openapi-spec-generation/SKILL.md | 7 - .../skills/dotnet-backend-patterns/SKILL.md | 7 - .../skills/angular-migration/SKILL.md | 29 --- .../skills/database-migration/SKILL.md | 30 --- .../skills/dependency-upgrade/SKILL.md | 61 ------ .../skills/react-modernization/SKILL.md | 29 --- .../nextjs-app-router-patterns/SKILL.md | 6 - .../skills/react-native-architecture/SKILL.md | 7 - .../skills/react-state-management/SKILL.md | 7 - .../skills/tailwind-design-system/SKILL.md | 8 - .../skills/godot-gdscript-patterns/SKILL.md | 6 - .../skills/unity-ecs-patterns/SKILL.md | 6 - .../employment-contract-templates/SKILL.md | 7 - .../skills/gdpr-data-handling/SKILL.md | 6 - .../incident-runbook-templates/SKILL.md | 7 - .../skills/on-call-handoff-patterns/SKILL.md | 173 ------------------ .../skills/postmortem-writing/SKILL.md | 6 - .../javascript-testing-patterns/SKILL.md | 7 - .../modern-javascript-patterns/SKILL.md | 8 - .../skills/nodejs-backend-patterns/SKILL.md | 7 - .../skills/typescript-advanced-types/SKILL.md | 7 - .../skills/helm-chart-scaffolding/SKILL.md | 6 - .../skills/k8s-security-policies/SKILL.md | 5 - .../skills/embedding-strategies/SKILL.md | 8 - .../hybrid-search-implementation/SKILL.md | 6 - .../skills/langchain-architecture/SKILL.md | 32 ---- .../skills/llm-evaluation/SKILL.md | 29 --- .../prompt-engineering-patterns/SKILL.md | 7 - .../skills/rag-implementation/SKILL.md | 28 --- .../similarity-search-patterns/SKILL.md | 7 - .../skills/vector-index-tuning/SKILL.md | 6 - .../skills/distributed-tracing/SKILL.md | 5 - .../skills/grafana-dashboards/SKILL.md | 6 - .../skills/prometheus-configuration/SKILL.md | 6 - .../skills/slo-implementation/SKILL.md | 5 - .../skills/billing-automation/SKILL.md | 29 --- .../skills/paypal-integration/SKILL.md | 28 --- .../skills/pci-compliance/SKILL.md | 32 ---- .../skills/stripe-integration/SKILL.md | 30 --- .../skills/async-python-patterns/SKILL.md | 22 --- .../skills/python-packaging/SKILL.md | 22 --- .../python-performance-optimization/SKILL.md | 23 --- .../skills/python-testing-patterns/SKILL.md | 22 --- .../skills/uv-package-manager/SKILL.md | 21 --- .../skills/backtesting-frameworks/SKILL.md | 6 - .../skills/risk-metrics-calculation/SKILL.md | 6 - .../skills/attack-tree-construction/SKILL.md | 6 - .../security-requirement-extraction/SKILL.md | 6 - .../skills/stride-analysis-patterns/SKILL.md | 6 - .../skills/threat-mitigation-mapping/SKILL.md | 6 - .../skills/bash-defensive-patterns/SKILL.md | 6 - .../skills/bats-testing-patterns/SKILL.md | 7 - .../skills/shellcheck-configuration/SKILL.md | 6 - .../skills/competitive-landscape/SKILL.md | 13 -- .../skills/market-sizing-analysis/SKILL.md | 21 --- .../startup-financial-modeling/SKILL.md | 19 -- .../skills/startup-metrics-framework/SKILL.md | 15 -- .../skills/team-composition-analysis/SKILL.md | 13 -- .../skills/go-concurrency-patterns/SKILL.md | 6 - .../skills/memory-safety-patterns/SKILL.md | 6 - .../skills/rust-async-patterns/SKILL.md | 6 - .../skills/accessibility-compliance/SKILL.md | 8 - .../skills/design-system-patterns/SKILL.md | 8 - .../skills/interaction-design/SKILL.md | 7 - .../skills/mobile-android-design/SKILL.md | 7 - .../skills/mobile-ios-design/SKILL.md | 7 - .../skills/react-native-design/SKILL.md | 8 - .../skills/responsive-design/SKILL.md | 8 - .../skills/visual-design-foundations/SKILL.md | 8 - .../skills/web-component-design/SKILL.md | 8 - 118 files changed, 3 insertions(+), 1492 deletions(-) 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/)