Skip to content

docs(skill): refresh conductor skill with latest features#187

Merged
jrob5756 merged 1 commit into
mainfrom
docs/update-conductor-skill
May 14, 2026
Merged

docs(skill): refresh conductor skill with latest features#187
jrob5756 merged 1 commit into
mainfrom
docs/update-conductor-skill

Conversation

@jrob5756
Copy link
Copy Markdown
Collaborator

Refreshes the .claude/skills/conductor skill so it accurately reflects the current CLI surface, schema, and feature set.

SKILL.md

  • Quick reference: added show, replay, --metadata, --workspace-instructions, and update --apply.
  • Key Concepts: added type: workflow, dialog, retry, hooks, metadata, instructions, agent-level timeout_seconds, the openai-agents provider, and dashboard sub-workflow dive-in / replay.

references/execution.md

  • New sections for conductor show and conductor replay.
  • run: documented --metadata / -m, --workspace-instructions, --instructions.
  • resume: now at run-flag parity — added --provider, --metadata, --web, --web-port, --web-bg; documented dashboard replay caveat and the intentionally-not-mirrored flags.
  • update: corrected — default prints the install command; --apply launches the installer; documented CONDUCTOR_NO_UPDATE_CHECK and the legacy --force no-op.
  • validate: added the new semantic checks and the `system_prompt`-without-`prompt` warning.
  • Registry: noted that bare/latest refs resolve to the default branch HEAD (not newest tag) and the new workflow#ref syntax (tag / branch / SHA).
  • Provider override and env vars: added openai-agents / OPENAI_API_KEY.

references/authoring.md

  • Workflow config: added hooks, metadata, instructions.
  • Agent schema: added timeout_seconds, retry, dialog blocks.
  • New sections: Sub-Workflow Agents (type: workflow, input_mapping, max_depth, for_each fan-out) and Dialog Mode.
  • New section: Workflow Metadata and Workspace Instructions covering the YAML fields and both CLI flags.
  • Script: documented JSON-stdout auto-merge with example; corrected restriction list.
  • Template variables: added workflow.dir and workflow.file.

references/yaml-schema.md

  • WorkflowDef: added metadata and instructions.
  • AgentDef: added workflow, input_mapping, max_depth, timeout_seconds, dialog; expanded restriction notes for script and workflow types.
  • runtime.provider: added openai-agents.
  • Template vars: added workflow.dir / workflow.file.
  • Validation: documented unknown-fields-rejected on WorkflowConfig / AgentDef / ParallelGroup / ForEachDef.

How verified

Cross-checked every change against src/conductor/cli/app.py, src/conductor/cli/registry.py, src/conductor/config/schema.py, the docs/ tree, and the most recent CHANGELOG.md entries (0.1.10 → 0.1.15).

Update the .claude/skills/conductor skill to reflect the current CLI,
schema, and feature set:

- SKILL.md: add show, replay, --metadata, --workspace-instructions, and
  update --apply to the quick reference; expand Key Concepts with
  type: workflow, dialog, retry, hooks, metadata, instructions, agent
  timeout_seconds, and the openai-agents provider.
- references/execution.md: document show, replay, run/resume flag parity
  (--metadata, --workspace-instructions, --instructions, --web on
  resume), corrected update behavior (default prints install command;
  --apply launches installer), CONDUCTOR_NO_UPDATE_CHECK, validate
  semantic checks, registry latest=branch-HEAD and #ref syntax, and
  openai-agents provider override.
- references/authoring.md: add hooks, metadata, instructions to
  workflow config; add timeout_seconds, retry, dialog blocks to agent
  schema; new Sub-Workflow Agents and Dialog Mode sections; document
  script JSON-stdout auto-merge; add workflow.dir and workflow.file
  template variables; add openai-agents provider.
- references/yaml-schema.md: add metadata and instructions to
  WorkflowDef; add workflow, input_mapping, max_depth, timeout_seconds,
  and dialog to AgentDef with full restriction notes; add openai-agents
  to runtime.provider; document unknown-fields-rejected validation.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@jrob5756 jrob5756 merged commit b9d538b into main May 14, 2026
9 checks passed
@jrob5756 jrob5756 deleted the docs/update-conductor-skill branch May 14, 2026 13:57
@jrob5756 jrob5756 mentioned this pull request May 14, 2026
jrob5756 added a commit that referenced this pull request May 14, 2026
- feat(engine): registry references in sub-workflow workflow: field (#188)
- feat: Claude Code plugin marketplace (#186)
- docs(skill): refresh conductor skill with latest features (#187)
- docs: rewrite 'Why Conductor?' README section (#185)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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