create-stateful-skill

name	create-stateful-skill
plugin	agent-scaffolders
description	Scaffolds an advanced stateful agent skill with session memory and state management. NOT for simple stateless skills (use `create-skill`) and NOT for GitHub agentic workflows (use `create-agentic-workflow`).
argument-hint	[skill-name]
allowed-tools	Bash, Read, Write

Follow the create-stateful-skill skill workflow to scaffold an advanced agent skill with L4 state management, lifecycle artifacts, and chained commands.

Inputs

• $ARGUMENTS — optional skill name or use-case description. Omit to start with discovery.

Steps

1. If $ARGUMENTS provides a skill name or context, use it to seed discovery
2. Follow the create-stateful-skill phased workflow: confirm which L4 patterns are needed (state management, lifecycle artifacts, tone configuration, chained commands, escalation taxonomy), design the state schema and lifecycle checkpoints, then scaffold the skill directory with full L4 scaffolding
3. Report created skill path and explain the state management strategy

Output

Skill directory with SKILL.md implementing selected L4 patterns, state schema, lifecycle artifact templates, and chained command definitions.

Edge Cases

• If $ARGUMENTS is empty: begin with discovery — identify which L4 patterns apply
• If the use case is simple (no persistent state, no chaining): recommend create-skill instead — stateful scaffolding adds complexity that simple skills don't need
• If the workflow requires human checkpoints: design explicit escalation taxonomy steps