Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 32 additions & 1 deletion .agents/skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@ CellixJS skills follow the agentskills.io directory convention:
├── mongodb-connection/ # Community skill for MongoDB connection tuning
├── mongodb-mcp-setup/ # Community skill for MongoDB MCP configuration
├── mongodb-query-optimizer/ # Community skill for MongoDB query/index performance
└── mongodb-schema-design/ # Community skill for MongoDB schema modeling
├── mongodb-schema-design/ # Community skill for MongoDB schema modeling
└── turbo-graph-optimization/ # CellixJS-authored skill for Turborepo task graph optimization
.github/skills/ # Symlinks for GitHub Copilot discovery
└── <skill-name> -> ../../.agents/skills/<skill-name>
Expand Down Expand Up @@ -86,6 +87,36 @@ skills-lock.json # Upstream source + hash metadata for insta
- [EXAMPLES.md](madr-enforcement/EXAMPLES.md) - Code examples following ADRs
- [All ADRs](../../apps/docs/docs/decisions/) - Source of architectural standards

### Turborepo Task Graph Optimization

**Purpose:** Autonomously analyze and optimize Turborepo task graphs to eliminate unnecessary transitive dependencies and improve build performance.

**Use Cases:**
- Build slowdown investigation (identifying task graph bloat)
- New package added pulling in unnecessary upstream tasks
- Periodic hygiene (quarterly/semi-annual reviews)
- Pre-release verification of build targets
- CI/CD optimization to reduce pipeline build time

**What This Skill Does:**
- Discovers build targets dynamically via `turbo query` (repo-agnostic)
- Analyzes transitive dependencies and identifies unnecessary tasks
- Proposes optimizations verified via static import analysis
- Applies safe changes and verifies build succeeds
- Flags unsafe changes (dynamic imports, runtime deps) for human review
- Generates before/after comparison tables with results

**Key Features:**
- Fully autonomous workflow (no user confirmation steps)
- Works with any Turborepo 2.9+ monorepo (not hardcoded to CellixJS)
- Safety verification through import analysis and build testing
- Formatted results with task type breakdown and percentages

**References:**
- [SKILL.md](turbo-graph-optimization/SKILL.md) - Complete skill documentation
- [ADR-0019: Monorepo Structure and Turborepo](../../apps/docs/docs/decisions/0019-monorepo-turborepo.md) - CellixJS context
- [ADR-0024: Agent Skills Framework](../../apps/docs/docs/decisions/0024-madr-agent-skills.md) - Skills framework

### Installed Community Skills

| Skill | Source | Why it is kept in this repo |
Expand Down
Loading
Loading