agentleFS
egdev6egdev6/discord-project-manager/skills/openclaw-runtime-orchestrator/SKILL.md

openclaw-runtime-orchestrator

Skill4 starsChanged 5 months agoMITView on GitHub

Trigger: Discord runtime request, route, intent, runner, backend, SDD handoff. Select the safe runtime path before workflow skills.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 4 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill as the OpenClaw-facing entry point for Discord-originated runtime requests before invoking product workflow skills.

    line 12
  2. Very specific:

    Follow the contract in docs/architecture/discord-runtime-orchestrator.md:

    line 18
  3. Distinctive:

    Always emit artifact classification before runner selection.

    line 47
  4. Very specific:

    Always include discord-approval-gate for write-like flows.

    line 48
  5. Distinctive:

    Do not expose raw Discord IDs, secrets, transcripts, screenshots, or private payloads in repo artifacts.

    line 51
  6. Distinctive:

    Do not claim live Discord, production, publishing, scheduling, Buffer, or durable write success from no-op/model-mediated checks.

    line 52
  7. Very specific:

    Treat Gentle-AI SDD assets as preserved protocol/backend assets under .openclaw/skills, not legacy product skills.

    line 53
  8. Very specific:

    Keep existing runner behavior small: classification may become richer than the current intent families, but planning_content, sdd_dev_work, …

    line 84

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Activation Contract

Use this skill as the OpenClaw-facing entry point for Discord-originated runtime requests before invoking product workflow skills.

This skill does not execute writes, publish content, schedule content, mutate GitHub, or run Gentle SDD directly. It classifies the turn, selects the runner boundary, and returns reviewable execution metadata.

Runtime Pipeline

Follow the contract in docs/architecture/discord-runtime-orchestrator.md:

Discord event envelope
-> origin resolution
-> managed channel route
-> channel guide ref
-> context pack ref
-> skill pack ref
-> artifact classification
-> intent classification
-> runner selection
-> permission/confirmation gate
-> response-language policy
-> execution metadata
-> writeback policy

Runner Boundaries

Intent familyRunner/backendBoundary
planning_contentopenclaw-skill-surfaceUse scoped workflow skills selected by scoped-skill-resolver.
sdd_dev_workgentle-sddHandoff to Gentle SDD protocol assets only; do not treat product workflow skills as SDD executors.
clarification_neededresponse-onlyAsk for route or intent clarification; do not hydrate durable context.

Hard Rules

  • Resolve scope and effective skills before using any workflow skill.
  • Always emit artifact classification before runner selection.
  • Always include discord-approval-gate for write-like flows.
  • Match user-facing prose to the user's current Discord message language, using user_message_language and prose_reply_language; keep commands, snippets, schema keys, routes, paths, skill/backend names, and exact approval phrases in English.
  • Private context profile operations such as create, update, reference, bind, clone, and channel override proposals are write-like when they target durable private runtime state.
  • Do not expose raw Discord IDs, secrets, transcripts, screenshots, or private payloads in repo artifacts.
  • Do not claim live Discord, production, publishing, scheduling, Buffer, or durable write success from no-op/model-mediated checks.
  • Treat Gentle-AI SDD assets as preserved protocol/backend assets under .openclaw/skills, not legacy product skills.

Output Contract

Return a compact metadata block:

artifact_classification:
  artifact_type: <workflow_skill|private_context|runtime_capability|publication_flow|sdd_dev_work|ephemeral_draft>
  subtype: <profile|scope_binding|skill_contract|capability_config|connector_flow|none>
  operation: <read|draft|create|update|bind|reference|unbind|clone|execute|handoff>
  persistence_target: <repo|private-runtime|external-service|ephemeral>
  approval_required: <true|false>
  backup_required: <true|false>
  deployment_required: <true|false>
  runner_backend: <openclaw-skill-surface|gentle-sdd|response-only>
  writeback_policy: <auto-save|confirmation-required|draft|reject>
intent_family: <planning_content|sdd_dev_work|clarification_needed>
selected_backend_or_runner: <openclaw-skill-surface|gentle-sdd|response-only>
skill_pack_ref: <resolved-pack-or-none>
effective_skills: [<skill-name>]
mandatory_skills: [discord-approval-gate] # for write-like flows
approval_required: <true|false>
writes_attempted: false
user_message_language: <en|es|...>
prose_reply_language: <same-as-user_message_language>
technical_tokens_language: en
language_policy: prose-matches-current-message; technical-tokens-stay-english
boundary_notes: <one sentence>

Keep existing runner behavior small: classification may become richer than the current intent families, but planning_content, sdd_dev_work, and clarification_needed remain the only runner-selection families in this slice.

References

  • docs/architecture/discord-runtime-orchestrator.md
  • docs/architecture/discord-context-skill-packs.md
  • docs/architecture/discord-scoped-skills-registry.md
  • docs/architecture/discord-gentle-sdd-handoff.md
  • skills/scoped-skill-resolver/SKILL.md
  • skills/discord-approval-gate/SKILL.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.