aibdd-form-activity

Translate Activity modeling elements into validated .activity DSL artifacts.

77|15|Updated May 12, 2026
One-click install
npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill aibdd-form-activity-waterball-software-academy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aibdd-form-activity
Source: https://github.com/Waterball-Software-Academy/aixbdd/tree/main/.agents/skills/aibdd-form-activity
Command: npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill aibdd-form-activity-waterball-software-academy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires json, argparse, re, sys, dataclasses, pathlib, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Converts already-completed Activity modeling elements produced during discovery into the project’s executable .activity DSL artifact, with strict syntax validation so the downstream workflow has a trustworthy spec.

Core Features & Use Cases

  • Boundary-safe translation: rewrites each Activity element into the corresponding .activity grammar without re-deciding actors, action granularity, reuse, partitioning, or requirement semantics.
  • Contract-validated intake: verifies the caller payload shape (target_path, format, and modeling completion signals) and refuses to write partial/invalid artifacts.
  • On-demand syntax gate: validates the generated .activity file by running the decoder against the written output and returns a structured validation report.
  • Traceable writes: writes the DSL to the requested target_path and returns JSON status plus syntax validation outcome.

Quick Start

Ask the system to run aibdd-form-activity with the discovery-produced activity_analysis payload and a target_path ending in .activity to generate and validate the corresponding DSL file.

Frequently Asked Questions about aibdd-form-activity

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

FAQPage Schema
How do I translate activity models into a validated DSL format?

Activity models are translated into boundary-safe .activity DSL artifacts by rewriting each modeling element into the corresponding grammar, enforcing payload schema, and passing strict decoder-based syntax validation before writing to the target path.

What is an .activity DSL file used for in event-stream planning?

An .activity DSL file materializes activity analysis outputs into a flattened event-stream representation, serving as a trustworthy executable spec for subsequent workflow planning and execution phases.

How do I validate .activity DSL syntax after generating the file?

The generated .activity file is validated by running a strict decoder against the written output, which checks syntax correctness and returns a structured validation report indicating pass or failure.

Does the activity DSL generator re-decide actors or action granularity from the input model?

No, the boundary-safe translation rewrites each Activity element into the .activity grammar without re-deciding actors, action granularity, reuse, partitioning, or requirement semantics from the discovery phase.

Can I generate an .activity DSL artifact from a partially completed activity model?

No, contract-validated intake verifies the caller payload shape and modeling completion signals, refusing to write partial or invalid artifacts that lack the required discovery-to-planning contract requirements.

What happens when activity DSL syntax validation fails during generation?

When decoder-based syntax validation fails, the system returns a structured validation report detailing the syntax errors found in the written .activity output, preventing untrusted specs from entering downstream execution.