AI Agent Skill HUB

dipeo-codegen-pipeline

Router skill for DiPeO code generation pipeline (TypeScript specs → IR → Python/GraphQL). Use when task mentions TypeScript models, IR builders, generated code diagnosis, or codegen workflow. For simple tasks, handle directly; for complex work, escalate to dipeo-codegen-pipeline agent.

12 stars
bysorryhyun
View on GitHubInstallation ↓

Best use case

dipeo-codegen-pipeline is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Router skill for DiPeO code generation pipeline (TypeScript specs → IR → Python/GraphQL). Use when task mentions TypeScript models, IR builders, generated code diagnosis, or codegen workflow. For simple tasks, handle directly; for complex work, escalate to dipeo-codegen-pipeline agent.

Teams using dipeo-codegen-pipeline should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/dipeo-codegen-pipeline/SKILL.md --create-dirs "https://raw.githubusercontent.com/sorryhyun/DiPeO/main/.claude/skills/dipeo-codegen-pipeline/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/dipeo-codegen-pipeline/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How dipeo-codegen-pipeline Compares

Feature / Agentdipeo-codegen-pipelineStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Router skill for DiPeO code generation pipeline (TypeScript specs → IR → Python/GraphQL). Use when task mentions TypeScript models, IR builders, generated code diagnosis, or codegen workflow. For simple tasks, handle directly; for complex work, escalate to dipeo-codegen-pipeline agent.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

AI Agents for Coding

Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.

Best AI Skills for Claude

Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.

SKILL.md Source

# DiPeO Codegen Pipeline Router

**Domain**: Complete TypeScript → IR → Python/GraphQL pipeline (`/dipeo/models/src/`, `/dipeo/infrastructure/codegen/`, generated code diagnosis).

## Quick Decision: Skill or Agent?

### ✅ Handle Directly (This Skill)
- **Simple lookups**: Understanding codegen workflow, reviewing TypeScript specs
- **Read-only tasks**: Checking generated code structure, reviewing IR output
- **Pattern reference**: snake_case naming rules, type mapping examples
- **Small spec tweaks**: Minor TypeScript field changes (<5 lines, 1 file)
- **Workflow questions**: "How do I run codegen?", "What's the IR structure?"

### ❌ Escalate to Agent
- **New node types**: Creating complete TypeScript specs with IR builders
- **IR builder changes**: Modifying AST processing, type conversion logic
- **Generated code diagnosis**: Tracing why generated code is wrong
- **Template modifications**: Changing Jinja templates for code generation
- **Complex spec changes**: Multi-field changes affecting multiple generated files
- **Type system updates**: Changes to UnifiedTypeConverter or type mappings

**Agent**: `Task(dipeo-codegen-pipeline, "your detailed task description")`

## Documentation Sections (Load On-Demand)

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

**Part 1: TypeScript Model Design**:
- `docs/agents/codegen-pipeline.md#your-role-as-model-architect` - Model locations and structure
- `docs/agents/codegen-pipeline.md#type-system-design-principles` - **CRITICAL**: snake_case and type safety
- `docs/agents/codegen-pipeline.md#workflows` - Creating/modifying node types

**Part 2: IR Builder System**:
- `docs/agents/codegen-pipeline.md#ir-builder-architecture` - Architecture and directory structure
- `docs/agents/codegen-pipeline.md#pipeline-system` - Pipeline, type conversion, AST processing

**Part 3: Code Generation**:
- `docs/agents/codegen-pipeline.md#template-system` - Templates and generated code structure
- `docs/agents/codegen-pipeline.md#generation-workflow` - Complete make codegen workflow

**Part 4: Diagnosis**:
- `docs/agents/codegen-pipeline.md#your-critical-responsibility` - Tracing TypeScript → IR → Python

**Part 5 & 6: Workflow & Collaboration**:
- `docs/agents/codegen-pipeline.md#complete-workflow` - End-to-end steps and validation
- `docs/agents/codegen-pipeline.md#when-to-engage-other-agents` - Escalation paths

**Example doc-lookup call**:
```bash
python .claude/skills/doc-lookup/scripts/section_search.py \
  --query "naming-standards" \
  --paths docs/agents/codegen-pipeline.md \
  --top 1
```

## Escalation to Other Agents

**To dipeo-package-maintainer**: Runtime handler issues, service architecture (if generated code is correct)
**To dipeo-backend**: GraphQL schema deployment, server config (if generation is correct)

## Typical Workflow

1. **Assess complexity**: Simple lookup/guidance vs. complex generation task
2. **If simple**: Load relevant section via `Skill(doc-lookup)`, provide guidance
3. **If diagnosis needed**: Trace TypeScript → IR → Python (use diagnosis docs)
4. **If complex**: Escalate with `Task(dipeo-codegen-pipeline, "task details")`

Related Skills

dipeo-package-maintainer

12
from sorryhyun/DiPeO

Router skill for DiPeO runtime Python code (execution handlers, service architecture, domain models, LLM infrastructure). Use when task mentions node handlers, EventBus, ServiceRegistry, Envelope pattern, or domain logic. For simple tasks, handle directly; for complex work, escalate to dipeo-package-maintainer agent.

dipeo-frontend-dev

12
from sorryhyun/DiPeO

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.

dipeo-backend

12
from sorryhyun/DiPeO

Router skill for DiPeO backend ecosystem (server/ and cli/): FastAPI server, CLI tools, database, MCP integration. Use when task mentions CLI commands, server endpoints, database queries, or MCP tools. For simple tasks, handle directly; for complex work, escalate to dipeo-backend agent.

todo-manage

12
from sorryhyun/DiPeO

Manage and organize TODO.md at project root - plan features, track progress, mark tasks complete, and clean up completed items. Use when planning tasks, organizing work, reviewing priorities, or managing the project TODO list. Access via /dipeotodos command.

test-backend-router

12
from sorryhyun/DiPeO

Test implementation of thin router skill for DiPeO backend. Provides decision criteria and documentation anchors for FastAPI server, CLI (dipeo run/results/metrics/compile/export), SQLite schema, and MCP integration in apps/server/. Use when task mentions CLI commands, server endpoints, database queries, or MCP tools.

separate-monolithic-python

12
from sorryhyun/DiPeO

Break large Python files (>500 LOC) into smaller, well-organized modules with proper package structure. Use when a Python file is too large, monolithic, or needs refactoring. Triggered by requests mentioning "too large", "separate", "split", "break up", or "refactor" for Python files.

maintain-docs

12
from sorryhyun/DiPeO

Update and maintain documentation to reflect current implementation after code changes, refactoring, or new features. Remove temporal language, verify accuracy against code, and keep docs current. Use when updating docs, syncing documentation, removing outdated info, or after implementing features.

import-refactor

12
from sorryhyun/DiPeO

Update all import statements, module references, string paths, and config references after moving or renaming files and modules. Handles Python, TypeScript, and JavaScript imports. Use when moving files, renaming modules, restructuring directories, or consolidating code.

skill-generator

12
from sorryhyun/DiPeO

Create new Claude Code skills with proper structure and best practices. Use when the user wants to create a new skill, extend Claude's capabilities, or needs help structuring a SKILL.md file.

doc-lookup

12
from sorryhyun/DiPeO

Locate and retrieve specific documentation sections from DiPeO's docs/ by heading anchors or keywords. Returns minimal, targeted excerpts instead of full files. Use when you need precise documentation context without loading entire guides.

clean-comments

12
from sorryhyun/DiPeO

Remove unnecessary, redundant, or obvious code comments while preserving valuable explanations. Use when cleaning up comments, removing verbose documentation, simplifying inline comments, or preparing code for review.

integrating-sast-into-github-actions-pipeline

16
from plurigrid/asi

This skill covers integrating Static Application Security Testing (SAST) tools—CodeQL and Semgrep—into GitHub Actions CI/CD pipelines. It addresses configuring automated code scanning on pull requests and pushes, tuning rules to reduce false positives, uploading SARIF results to GitHub Advanced Security, and establishing quality gates that block merges when high-severity vulnerabilities are detected.