agentleFS
sdwurg180507280211sdwurg180507280211/my-skills/skills/openmaic/SKILL.md

openmaic

Skill1 starsChanged 38 days agoMITView on GitHub

OpenMAIC assistant for setting up, generating, and extending OpenMAIC. Use when the user wants to use OpenMAIC, generate a multi-agent interactive classroom, or build on / extend / customize OpenMAIC and its @openmaic/* SDK (secondary development, 二开) — covers Live Demo or local setup, startup modes, provider keys, classroom generation, and secondary development (forking, providers/storage/themes, routes, or the renderer/editor).

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

25 rules. About 0 are common, 20 are distinctive, and 5 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈20

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 5

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this as a guided, confirmation-heavy SOP.

    line 10
  2. Distinctive:

    Before any state-changing action, ask for confirmation.

    line 15
  3. Distinctive:

    If local state already exists, show what you found and ask whether to keep it.

    line 16
  4. Distinctive:

    Do not assume the OpenClaw agent's own model or API key will be reused by OpenMAIC.

    line 17
  5. Distinctive:

    Only OpenMAIC server-side config files may control provider selection and defaults.

    line 20
  6. Distinctive:

    Do not default to asking the user to paste API keys into chat.

    line 21
  7. Distinctive:

    Prefer guiding the user to edit local config files themselves.

    line 22
  8. Distinctive:

    Do not offer to write API keys into config files on the user's behalf.

    line 23
  9. Distinctive:

    Keep confirmations for local file reads such as reading a PDF from disk.

    line 25
  10. Very specific:

    If present, read defaults from ~/.openclaw/openclaw.json under:

    line 29
  11. Very specific:

    If accessCode is present, default to Live Demo mode and skip the mode-selection prompt — unless the user's intent is to extend/build on …

    line 48
  12. Very specific:

    Use repoDir and url only as defaults for local mode.

    line 49
  13. Very specific:

    If no accessCode in config (or the extend exception above applies), ask the user how they want to use OpenMAIC:

    line 58
  14. Distinctive:

    If the user chooses Live Demo mode, load references/live-demo.md and skip phases 1–4.

    line 64
  15. Distinctive:

    If the user chooses local mode, proceed to phase 1 as usual.

    line 65
  16. Distinctive:

    If the user chooses to extend/build on OpenMAIC, load references/extend.md and skip the setup/generation phases.

    line 66
  17. Distinctive:

    Use this when the user has not installed OpenMAIC yet or when you need to confirm which local checkout to use.

    line 72
  18. Distinctive:

    Use this after the repo location is confirmed.

    line 78
  19. Distinctive:

    After the core LLM key is configured, ask the user if they want to enable optional features (web search, image generation, video …

    line 86
  20. Very specific:

    After the user has chosen a startup mode and configured keys, start OpenMAIC using the chosen method, then verify the service with GET …

    line 90
  21. Distinctive:

    Keep each step short and explicit.

    line 100
  22. Distinctive:

    Prefer 2-3 concrete options when the user must choose.

    line 101
  23. Distinctive:

    Always include the recommended option first and explain why in one sentence.

    line 102
  24. Distinctive:

    After a step completes, say what changed and what the next confirmation is for.

    line 103
  25. Distinctive:

    When returning a classroom link, place the raw absolute URL on its own line with no bold, markdown link syntax, code formatting, or tables.

    line 104

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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

OpenMAIC Skill

Use this as a guided, confirmation-heavy SOP. Do not compress the whole setup into one reply and do not perform state-changing actions without explicit user confirmation.

Core Rules

  • Move one phase at a time.
  • Before any state-changing action, ask for confirmation.
  • If local state already exists, show what you found and ask whether to keep it.
  • Do not assume the OpenClaw agent's own model or API key will be reused by OpenMAIC.
  • OpenMAIC classroom generation uses OpenMAIC server-side provider config.
  • This skill must not rely on any request-time model or provider overrides.
  • Only OpenMAIC server-side config files may control provider selection and defaults.
  • Do not default to asking the user to paste API keys into chat.
  • Prefer guiding the user to edit local config files themselves.
  • Do not offer to write API keys into config files on the user's behalf.
  • Once setup is complete and the user clearly asks to generate a classroom, do not ask for a second confirmation before submitting the generation job.
  • Keep confirmations for local file reads such as reading a PDF from disk.

Optional Skill Config

If present, read defaults from ~/.openclaw/openclaw.json under:

{
  "skills": {
    "entries": {
      "openmaic": {
        "enabled": true,
        "config": {
          "accessCode": "sk-xxx",
          "repoDir": "/path/to/OpenMAIC",
          "url": "http://localhost:3000"
        }
      }
    }
  }
}
  • If accessCode is present, default to Live Demo mode and skip the mode-selection prompt — unless the user's intent is to extend/build on OpenMAIC (see the exception in Phase 0).
  • Use repoDir and url only as defaults for local mode.
  • Still confirm before acting.

SOP Phases

0. Choose Mode

First check skill config for accessCode. If present, announce that a stored access code was found and proceed directly to Live Demo mode (load references/live-demo.md, skip phases 1–4). Do not ask the user to paste the code again. Exception: if the user's stated intent is to extend / build on / customize OpenMAIC or consume the @openmaic/* SDK (二次开发 / 二开 / SDK), do not auto-shortcut — go to the extend branch below regardless of accessCode. A returning Live Demo user who now wants to do 二开 should be routed to extend, not silently sent back to Live Demo.

If no accessCode in config (or the extend exception above applies), ask the user how they want to use OpenMAIC:

  1. Use the OpenMAIC Live Demo (recommended for quick start) — The cloud edition: the version officially deployed and hosted by the OpenMAIC team at open.maic.chat. Requires an access code (starts with sk-). Get yours by signing in at https://open.maic.chat, clicking your account in the top-right corner, opening "访问码设置" (access code settings), and generating a code; then add it to ~/.openclaw/openclaw.json under skills.entries.openmaic.config.accessCode. No local setup needed.
  2. Run locally — Clone the repo, configure provider keys, and run on your machine.
  3. Extend or build on OpenMAIC (二次开发) — Fork the repo and customize the product, or consume the @openmaic/* SDK to build something new.

If the user chooses Live Demo mode, load references/live-demo.md and skip phases 1–4. If the user chooses local mode, proceed to phase 1 as usual. If the user chooses to extend/build on OpenMAIC, load references/extend.md and skip the setup/generation phases.

1. Clone Or Reuse Existing Repo

Load references/clone.md.

Use this when the user has not installed OpenMAIC yet or when you need to confirm which local checkout to use.

2. Choose Startup Mode

Load references/startup-modes.md.

Use this after the repo location is confirmed. Present the available startup modes, recommend one, and wait for the user's choice.

3. Configure Provider Keys

Load references/provider-keys.md.

Use this before starting classroom generation. Recommend a provider path and tell the user exactly which config file to edit themselves. If generation later fails due to provider/model/auth issues, return to this phase and direct the user to update the same server-side config files.

After the core LLM key is configured, ask the user if they want to enable optional features (web search, image generation, video generation, TTS). Each requires its own provider key — see the "Optional Features" section in provider-keys.md.

4. Start And Verify OpenMAIC

After the user has chosen a startup mode and configured keys, start OpenMAIC using the chosen method, then verify the service with GET {url}/api/health.

5. Generate A Classroom

Load references/generate-flow.md.

Use this only after the service is healthy. Confirm before reading local PDFs. If the user has already clearly asked to generate, do not ask for a second confirmation before submitting the generation job, and then follow the polling loop until it succeeds or fails. Only send the supported content fields for generation requests. For long-running jobs, prefer sparse polling and tell the user to check back later if the turn ends before completion.

Response Style

  • Keep each step short and explicit.
  • Prefer 2-3 concrete options when the user must choose.
  • Always include the recommended option first and explain why in one sentence.
  • After a step completes, say what changed and what the next confirmation is for.
  • When returning a classroom link, place the raw absolute URL on its own line with no bold, markdown link syntax, code formatting, or tables.

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.