dipeo-frontend-dev

Router skill for DiPeO frontend (React, visual editor, GraphQL integration, TypeScript types). Use when task mentions React components, diagram editor, GraphQL hooks, or type errors. For simple tasks, handle directly; for complex work, escalate to dipeo-frontend-dev agent.

⭐13stars🔀2forks📁View on GitHub🕐Updated Dec 31, 2025⬇️2downloads

When & Why to Use This Skill

This Claude skill acts as an intelligent orchestration layer for DiPeO frontend development. It optimizes developer workflows by triaging tasks related to React components, XYFlow diagram editors, and GraphQL integrations, handling minor fixes directly while escalating complex architectural changes to specialized agents to ensure efficient resource allocation.

Use Cases

  • Case 1: Resolving isolated TypeScript errors and minor UI styling adjustments within React components to maintain code health without full agent escalation.
  • Case 2: Providing instant access to GraphQL hook patterns and internal documentation for the DiPeO tech stack to speed up development.
  • Case 3: Automating task triage by assessing complexity to decide between immediate execution or routing to the dipeo-frontend-dev agent.
  • Case 4: Performing quick code quality checks and pattern references to ensure consistency across the frontend codebase during small-scale refactoring.
namedipeo-frontend-dev
descriptionRouter skill for DiPeO frontend (React, visual editor, GraphQL integration, TypeScript types). Use when task mentions React components, diagram editor, GraphQL hooks, or type errors. For simple tasks, handle directly; for complex work, escalate to dipeo-frontend-dev agent.
allowed-toolsRead, Grep, Glob, Bash, Skill

DiPeO Frontend Dev Router

Domain: React components, visual diagram editor (XYFlow), GraphQL integration, TypeScript types in /apps/web/src/.

Quick Decision: Skill or Agent?

✅ Handle Directly (This Skill)

  • Simple fixes: <20 lines, 1-2 files
  • Quick type fixes: Single TypeScript error in one file
  • Documentation lookups: "Where is X?", "What hooks are available?"
  • Small styling changes: Update component layout, add simple UI element
  • Pattern reference: GraphQL hook usage examples

❌ Escalate to Agent

  • TypeScript type fixing: Multiple related errors, GraphQL schema mismatches, complex generics
  • Feature implementation: New diagram editor features, multi-step UI workflows
  • Refactoring: Component hierarchy changes, extracting shared logic
  • Complex debugging: Runtime errors across components, state synchronization issues

Agent: Task(dipeo-frontend-dev, "your detailed task description")

Documentation Sections (Load On-Demand)

Use Skill(doc-lookup) with these anchors when you need detailed context:

Core Responsibilities & Tech Stack:

  • docs/agents/frontend-development.md#your-core-responsibilities - React, diagram editor, GraphQL, TypeScript
  • docs/agents/frontend-development.md#technical-context - Tech stack and project structure

Code Quality & Patterns:

  • docs/agents/frontend-development.md#code-quality-standards - Component patterns, GraphQL, state management
  • docs/agents/frontend-development.md#common-patterns - Hooks, factory functions, error boundaries

Constraints & Escalation:

  • docs/agents/frontend-development.md#important-constraints - What not to modify
  • docs/agents/frontend-development.md#when-to-escalate - When to escalate to other agents

Example doc-lookup call:

python .claude/skills/doc-lookup/scripts/section_search.py \
  --query "graphql-usage" \
  --paths docs/agents/frontend-development.md \
  --top 1

Escalation to Other Agents

To dipeo-backend: GraphQL schema modifications, server API changes To dipeo-codegen-pipeline: TypeScript model definitions, generated type issues To dipeo-package-maintainer: New node type backend handlers

Typical Workflow

  1. Assess complexity: Simple fix vs. complex implementation
  2. If simple: Load relevant section via Skill(doc-lookup), make change directly
  3. If complex: Escalate with Task(dipeo-frontend-dev, "task details")
  4. Always verify: Run pnpm typecheck before finalizing