Skip to content

Rename skill flow→clawflow + template docs ({{ inputs | json }}); v1.2.5#40

Merged
pallaoro merged 2 commits into
mainfrom
docs/flow-template-json-payload
Jun 26, 2026
Merged

Rename skill flow→clawflow + template docs ({{ inputs | json }}); v1.2.5#40
pallaoro merged 2 commits into
mainfrom
docs/flow-template-json-payload

Conversation

@pallaoro

@pallaoro pallaoro commented Jun 26, 2026

Copy link
Copy Markdown
Member

Two changes, released as 1.2.5:

1. Rename skill flowclawflow

Skill names are effectively global identifiers, so the generic flow risked
collision/ambiguity. Renamed to match the plugin id:

  • skills/flowskills/clawflow
  • openclaw.plugin.json skills path + SKILL.md frontmatter nameclawflow

2. Template docs: whole-payload dumps

Agents were adding a redundant code node (JSON.stringify(state.inputs)
{{ raw_body }}) to put a full payload into a task, because the Templates
section only showed field access and buried the json filter. Added:

  • {{ inputs }} / {{ inputs | json }} whole-payload examples + a note that
    bare object refs render as JSON (not [object Object]).
  • A "Common mistake" callout against serializing with a code node.

(Companion: clawnify CLAWNIFY-TOOLS.md updated to reference the clawflow skill.)

pallaoro added 2 commits June 26, 2026 21:41
…arn against code-node serialization

Agents were adding a redundant `code` node (run: JSON.stringify(state.inputs)
→ {{ raw_body }}) to put a full payload into a task/prompt, because the
Templates section only showed field access and buried the `json` filter in a
table — never connecting it to the "dump the whole body" use case.

- Add `{{ inputs }}` (auto-JSON) and `{{ inputs | json }}` (explicit) examples,
  with a note that bare object/array refs render as JSON, not [object Object].
- Add a "Common mistake" callout: don't use a code node just to serialize state
  for a template — use `{{ x | json }}`.
Skill names are effectively global identifiers, so the generic `flow` risked
collision/ambiguity. Rename to match the plugin id (`clawflow`):
- skills/flow → skills/clawflow
- manifest skills path + frontmatter name → clawflow
- bump 1.2.4 → 1.2.5
@pallaoro pallaoro changed the title docs(flow skill): {{ inputs | json }} for whole-payload dumps + anti-pattern callout Rename skill flow→clawflow + template docs ({{ inputs | json }}); v1.2.5 Jun 26, 2026
@pallaoro pallaoro merged commit b5f3931 into main Jun 26, 2026
1 check passed
@pallaoro pallaoro deleted the docs/flow-template-json-payload branch June 26, 2026 20:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant