workflow-skill-creator · diff
git:20260617.c13a499 to git:20260805.9740c56
13 added, 21 removed. Audit A to A.
---
name: workflow-skill-creator
description: >-
- Distill a completed user interaction or multi-step workflow into a reusable agent skill (SKILL.md + helper script), registering it in skill-rules.json and SKILL_REGISTRY.md.
+ Compatibility alias for the deprecated /workflow-skill-creator workflow. Route new requests through foundry/skill-forge for typed contracts, portable packaging, and receipt-based proof.
---
- # Workflow Skill Creator
-
- ## Overview
-
- This skill enables the agent to package successful SAGE workflows or human interactions into reusable, config-driven agent skills under `skills/` or vertical domains.
+ # Workflow Skill Creator — Deprecated Alias
- ## Dependencies
+ Use `foundry/skill-forge` for all new work.
- - `orchestration/workflow-design`
- - `orchestration/agent-handoff-packet`
+ This alias remains only so explicit legacy invocations do not break. It must not require a brainstorming ceremony when the user has already supplied a complete brief.
- ## Quick Start
+ ## Compatibility flow
- To package a workflow:
- 1. Conduct Phase 1 (Brainstorming) with the user to refine inputs, outputs, rate limits, and approaches.
- 2. Search existing skills to see if any steps are already implemented (Rule 1: reuse and depend instead of duplicating).
- 3. Scaffold `SKILL.md` under `skills/<domain>/<name>/`.
- 4. If code is needed (API calls, data processing), generate a Python helper script using the `references/cli_script_template.py` template, incorporating rate limiting (Rule 2) and file-based output (Rule 4).
- 5. Append the skill in `skills/SKILL_REGISTRY.md` and add the trigger rule to `skills/skill-rules.json`.
- 6. Run `npm test test/v77-skill-rules.test.ts` to verify skill rule validity.
+ 1. Translate `/workflow-skill-creator <brief>` to `/forge skill <brief>`.
+ 2. Load `foundry/skill-forge`.
+ 3. Discover existing capabilities before creating a duplicate.
+ 4. Ask only for missing information that materially changes the package.
+ 5. Compile and prove before promotion or registration.
- ## Common Mistakes
+ ## Migration
- - **Skipping Brainstorming:** Creating a skill without Socratic user alignment leads to rigid or incorrect parameter scopes.
- - **Console Bloat (Rule 4 violation):** Printing huge API payloads to stdout instead of routing the output to local files, which consumes the agent's context window.
- - **API Rate Violations:** Forgetting to implement cross-process rate limits (defaulting to 1 req/sec if undocumented).
+ - Old: `/workflow-skill-creator "research brief workflow" ...`
+ - New: `/forge skill "research brief workflow" ...`