takt-workflow-builder

Creates TAKT workflow YAML files and facet files from user requirements.

Updated Jun 23, 2026
One-click install
npx skills add https://github.com/j5ik2o/marp-ai-base --skill takt-workflow-builder-j5ik2o
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: takt-workflow-builder
Source: https://github.com/j5ik2o/marp-ai-base/tree/main/.agents/skills/takt-workflow-builder
Command: npx skills add https://github.com/j5ik2o/marp-ai-base --skill takt-workflow-builder-j5ik2o

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Designing TAKT workflows by hand requires deep knowledge of the workflow YAML schema, rule syntax, parallel step semantics, and Faceted Prompting conventions. This Skill gathers your requirements and generates a consistent workflow YAML plus any needed facet files (personas, policies, instructions, knowledge, output contracts) in one pass. ## Core Features & Use Cases - Workflow YAML generation: Composes steps, transition rules (text conditions, ai(), all()/any(), deterministic when:), parallel review steps, subworkflow calls, system steps, structured outputs, and loop monitors. - Facet file generation: Creates custom personas, policies, instructions, knowledge, and output contracts following TAKT style conventions, while reusing builtin facets whenever possible. - Mechanical validation: Ships a validate-takt-files.sh script that checks required fields, initial_step references, facet file existence, and loop monitor consistency. - Use Case: Ask for a Rust backend workflow with a plan→implement→review→fix loop, and receive a complete workflow YAML placed under ~/.takt/ with builtin reviewer facets wired in and validated. ## Quick Start Ask the assistant to create a TAKT workflow for your project, describing the steps, review structure, and loop limits you need.

Frequently Asked Questions about takt-workflow-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom TAKT workflow YAML?

Describe your objective, step composition, review structure, and loop limits, and the Skill generates the workflow YAML under ~/.takt/workflows/. It reuses builtin workflows like default.yaml as patterns and only creates custom facets when builtins are insufficient.

How do I add parallel review steps to a TAKT workflow?

Define a step with a parallel block containing sub-steps for each reviewer. Sub-step rules only classify results; the parent step's rules use all() or any() aggregation to decide the next transition.

What facets does TAKT Faceted Prompting use?

TAKT uses five facet types: persona (role identity), policy (shared behavioral rules), instruction (step procedures), knowledge (reference material), and output contract (report structure). Each is a Markdown file referenced from the workflow YAML's section maps.

Can I validate TAKT workflow files automatically?

Yes, run the bundled validate-takt-files.sh script to check required fields like name, initial_step, and steps, verify facet file references exist, and check loop monitor consistency. Use --workflows or --facets to narrow the scope.

When should I use when: rules instead of condition: in TAKT?

Use when: for deterministic routing based on workflow state (context.*, structured.*, effect.*) with comparison and boolean operators, avoiding AI evaluation. Use text condition: for Phase 3 tag-based judgment, which is the recommended default for agent-driven decisions.