Agent skill

Cordis Plugin Development

by singula-ai in singula-ai/alego

A skill your agent uses when adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current Harness profile…

MITAuto-check passedAgent Workflows

Install Cordis Plugin Development

skills CLI
$ npx skills add singula-ai/alego --skill cordis-plugin-development -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install singula-ai/alego cordis-plugin-development --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/singula-ai/alego.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/preset/agent-preset/skills/cordis-plugin-development .claude/skills/cordis-plugin-development && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cordis-plugin-development
GitHub stars
109
Token cost
~1.9k tokens
SKILL.md length
945 words
Files
12 (incl. references)
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current Harness profile…

  • Works in 5 steps: Resolve the requested result and… → Discover only the APIs needed for that… → Read the matching template under… → …
  • Debugging a plugin
  • SKILL.md covers Enable a shipped plugin, Deliver a working plugin first, Knowledge sources, in order and Read next
  • Runs JavaScript scripts from its folder

What it does

Cordis Plugin Development is an agent skill from singula-ai/alego. Use when adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current Harness profile, including a shipped plugin that is disabled by default, and for any visual object, decoration, or widget request that names no other destination, which means an installed UI plugin rendered in the Harness Web UI.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 15 other files, including reference files (for example `references/host-plugin.md`, `references/mcp-bundle.md` and `references/practices.md`).

It sits in Agent Workflows, covering Hooks and plugins and Frontend development. It works with Model Context Protocol. The repository describes itself as: Build AI Agents like playing LEGOs. Everything is a Plugin. The licence is MIT.

When your agent uses it

  • Debugging a plugin
  • MCP connection in the current Harness profile
  • Including a shipped plugin that is disabled by default
  • For any visual object

Example prompts

  • “/cordis-plugin-development”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Resolve the requested result and destination. An unspecified visual destination is the current Harness Web UI; a standalone image or HTML…
  2. Discover only the APIs needed for that version: cordis_inspect_list, then targeted cordis_inspect_query calls. For UI, query Client…
  3. Read the matching template under templates/ with the file-read tool and write its copies into one workspace directory, or write the…
  4. Read the installation result: its application and warnings fields decide whether the change is live, not server logs, terminal output…
  5. Fix observed defects in the same plugin. When the requested result works, finish with its location and verification status. Do not…

What it can do on your machine

Read from SKILL.md and the folder at commit a79fe9a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (JavaScript), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cordis Plugin Development loads about 1.9k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 103 tokens; SKILL.md has 945 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from singula-ai/alego at commit a79fe9a, republished under its MIT licence (© singula-ai). 945 words, ~1,853 tokens.

Download SKILL.mdSave it as .claude/skills/cordis-plugin-development/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
cordis-plugin-development
description
Use when adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current Harness profile, including a shipped plugin that is disabled by default, and for any visual object, decoration, or widget request that names no other destination, which means an installed UI plugin rendered in the Harness Web UI.

Persistent Harness plugins

Use ordinary workspace files to author a bundle, then plugin_manager with action: install_bundle and the absolute package directory as target to install it in the current profile. Changes affect every session in that profile and survive restart. Load editing-cordis-compositions for agent preset changes.

Do not write the profile's package.json or cordis.patch.yml, create packages under $ALEGO_HOME, or run pnpm in the profile directory: install_bundle performs those steps, and each hand-made write outside the workspace needs its own approval. Every plugin_manager action, including list_plugins and list_bundles, also needs approval without Full access, so call it only when its result decides the next step.

Enable a shipped plugin

A shipped bundle can resolve a plugin row and leave it disabled. The row id and its reason are in the shipped patch, packages/bundle/*/cordis.patch.yml in a source checkout. Write a workspace bundle whose patch overrides that row with disabled: false and inserts the Host rows it depends on; a source checkout's apps/cli/config/examples/<feature>/cordis.yml lists them for opt-in features. Packages shipped with alego resolve from the alego installation, so the bundle declares no dependencies on them. Install it with install_bundle.

Deliver a working plugin first

  1. Resolve the requested result and destination. An unspecified visual destination is the current Harness Web UI; a standalone image or HTML file does not complete such a request. Choose reasonable visual details and implement a small first version; install it before visual refinement.
  2. Discover only the APIs needed for that version: cordis_inspect_list, then targeted cordis_inspect_query calls. For UI, query Client Slots.listSubTree and the selected slot's registration options and props. For anything beyond a static decoration, such as tool policy, agent context, session-derived state, or Chat rows, read references/practices.md before choosing the extension point. Once the chosen slot and registration API are known, write the plugin.
  3. Read the matching template under templates/ with the file-read tool and write its copies into one workspace directory, or write the installable package, patch, and required Host/Client files there yourself. Check JavaScript syntax and the manifest, then install it. Before that first installation, do not create preview HTML, mock shells, design variants, screenshot scripts, or rasterizer tooling. Use the installed plugin itself as the first preview.
  4. Read the installation result: its application and warnings fields decide whether the change is live, not server logs, terminal output, process lists, or the page's boot payload. Confirm new rows with cordis_inspect_query, which needs no approval, rather than paging list_plugins. After application: applied, exercise the capability or inspect the live Client registration. Use the connected page for visual verification when browser control is available. For a page or panel, also verify design consistency: styles use only theme tokens, the plugin imports no Harness Client package such as @singula-ai/alego-client-ui-primitives, the console shows no slot entry crash, and the view reads correctly in light and dark themes beside a comparable host page. State any verification limitation explicitly; installation and slot registration alone do not establish what the user can see.
  5. Fix observed defects in the same plugin. When the requested result works, finish with its location and verification status. Do not continue speculative visual variants, optional features, or a new mock preview. Close any task list you created.
Show full SKILL.md (412 more words)Show less

Knowledge sources, in order

  1. Inspection: cordis_inspect_query answers exact Service methods and Event modes (Service, Event), a mounted plugin's Config JSON Schema (Config.listConfigs: filter the paged directory by name, then query the entry id), the Tools this Agent can call (Tool), and live Client Slots and theme tokens (Slots, Theme).
  2. Package documentation: Config.listConfigs with name set to the package finds its entries; querying one entry returns its packageDir, the resolved package directory. Read <packageDir>/README.md. Bundled packages resolve from the alego installation and profile-installed bundles from the profile, so never guess the path from $ALEGO_PROFILE_DIR.
  3. Source: installed packages ship built lib/index.js and lib/types/**/*.d.ts with JSDoc under that same packageDir, not src/; a source checkout of ALEGO has packages/<group>/<name>/src. Read them when inspection and the README leave a question open, and start source-level diagnosis from a concrete installation or runtime failure.

ALEGO_PROFILE (profile name) and ALEGO_PROFILE_DIR (its directory, whose node_modules holds only profile-installed bundles) are set in every shell call of a profile-launched Harness and absent when the Harness was booted without a profile. Bash reads them as $ALEGO_PROFILE; PowerShell, which the Windows preset uses, reads them as $env:ALEGO_PROFILE. With alego on the PATH, alego --profile "$ALEGO_PROFILE" --dump-config prints the composed profile.

The files below live in this skill's base directory, which the skill tool reported, and the table is the complete list: do not enumerate that directory. In every deployment, including a source checkout, read these files with the file-read tool, write copies into the workspace with the file-write tool, and verify a copy by reading it back. In Desktop the directory sits inside app.asar, which only the Host process's own file reads can open; shell commands (ls, cat, cp, cmp), the glob and search tools (they run a native ripgrep process), node, and pnpm all fail on it. Never install or syntax-check a template in place; copy its contents into the workspace first.

TaskFile
Bundle manifest, display metadata and icon, install and enable semantics, Host plugin export forms, Configreferences/host-plugin.md
A UI plugin rendered in the Web page: Client manifest, module loader, slot registrationreferences/ui-plugin.md
Connecting an MCP server through a configuration-only bundlereferences/mcp-bundle.md
Verification limits when no browser control is availablereferences/verification.md
UI plugin starting point, four filestemplates/decoration/package.json, templates/decoration/cordis.patch.yml, templates/decoration/index.js, templates/decoration/client.js
MCP bundle starting point, two filestemplates/mcp/package.json, templates/mcp/cordis.patch.yml
Loader patch dialect and the list of installable plugin packagesthe cordis-composition-reference skill
Choosing extension points, contexts, and state mechanisms for upgrade stability and performancereferences/practices.md

© singula-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (references) in packages/preset/agent-preset/skills/cordis-plugin-development of singula-ai/alego.

  • SKILL.md
  • references/host-plugin.md
  • references/mcp-bundle.md
  • references/practices.md
  • references/ui-plugin.md
  • references/verification.md
  • templates/decoration/client.js
  • templates/decoration/cordis.patch.yml
  • templates/decoration/index.js
  • templates/decoration/package.json
  • templates/mcp/cordis.patch.yml
  • templates/mcp/package.json

Open the folder on GitHubat commit a79fe9a

Compare with similar skills

Cordis Plugin Development next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cordis Plugin Development compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cordis Plugin Development this skillsingula-ai/alego109—~1.9kAutomated safety check: PassMIT
Cordis Plugin DevelopmentZhou-Yujing114514/deepseek-harness-linux118—~2kAutomated safety check: PassMIT
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
Agent Setup Health Audittw93/Waza7.2k—~5.2kAutomated safety check: NotesMIT
Writing Pluginsnukeop/nuclear19k—~825Automated safety check: PassAGPL-3.0
Paseo Plugin Buildergetpaseo/paseo20k—~9.4kAutomated safety check: PassCustom licence

Similar skills

  • Cordis Plugin Development

    Zhou-Yujing114514/deepseek-harness-linux

    A skill your agent uses when designing, reviewing, adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current…

    118 GitHub stars~2k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Audits a project's agent configuration, instruction drift, hooks, MCP and AI maintainability, then reports prioritized findings with evidence and next actions.

    7.2k GitHub stars~5.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Writing Plugins

    nukeop/nuclear

    A skill your agent uses when writing, scaffolding, or modifying Nuclear plugins.

    19k GitHub stars~825 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Paseo Plugin Builder

    getpaseo/paseo

    Builds, installs and troubleshoots trusted local Paseo plugins, from lifecycle hooks and slash commands to screens, themes and timeline renderers.

    20k GitHub stars~9.4k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • New Command Docs

    tractorjuice/arc-kit

    This skill should be used when a new ArcKit command has been added and documentation needs updating across the repository.

    2.3k GitHub stars~2.3k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from singula-ai/alego

All 20 skills in this repo
  • Record Browser Gif

    singula-ai/alego

    Record browser or Web UI interaction demos as optimized GIFs using the available browser-control workflow, optional Playwright Videos for higher capture frame rates, and deterministic encoding, then…

    109 GitHub starsUsed in 1 repo~4.1k tokens
    Auto-check: notes
  • A skill your agent uses when adding, auditing, pruning, archiving, restoring, or reviewing Agent Notes in alego; checks every new note for superseded active records, deletes small UI and purely…

    109 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • A skill your agent uses when landing a stack of dependent GitHub PRs (A ← B ← C, where each bases on the one below) onto master, merging a PR whose base is another open PR's branch, or whenever a…

    109 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • A skill your agent uses when creating, changing, or validating an agent preset or other Cordis composition for this harness, including deciding host versus preset placement and checking that an…

    109 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Office DOCX

    singula-ai/alego

    Create, read, edit, and check Word documents (.docx), including reports, letters, and formatted tables.

    109 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Office PPTX

    singula-ai/alego

    Create, read, edit, and check PowerPoint presentations (.pptx), including slide text, tables, images, and charts.

    109 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed

Questions about Cordis Plugin Development

What does Cordis Plugin Development do?

A skill your agent uses when adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current Harness profile…. Cordis Plugin Development is an agent skill from singula-ai/alego. Use when adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current Harness profile, including a shipped plugin that is disabled by default, and for any visual object, decoration, or widget request that names no other destination, which means an installed UI plugin rendered in the Harness Web UI.

When should I use Cordis Plugin Development?

Cordis Plugin Development fits situations like: debugging a plugin; MCP connection in the current Harness profile; including a shipped plugin that is disabled by default; for any visual object.

How do I install Cordis Plugin Development in Claude Code?

Run `npx skills add singula-ai/alego --skill cordis-plugin-development -a claude-code`. Or copy the skill folder (packages/preset/agent-preset/skills/cordis-plugin-development in singula-ai/alego) into .claude/skills/cordis-plugin-development in your project. Claude Code loads it when a task matches its description.

How do I install Cordis Plugin Development in Codex?

Run `npx skills add singula-ai/alego --skill cordis-plugin-development -a codex`. Or copy the skill folder (packages/preset/agent-preset/skills/cordis-plugin-development in singula-ai/alego) into .agents/skills/cordis-plugin-development in your project. Codex loads it when a task matches its description.

Can I use Cordis Plugin Development in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add singula-ai/alego --skill cordis-plugin-development -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cordis-plugin-development, .gemini/skills/cordis-plugin-development, .github/skills/cordis-plugin-development and .opencode/skills/cordis-plugin-development in your project.

What does Cordis Plugin Development need to run?

Going by SKILL.md and its folder, Cordis Plugin Development needs JavaScript for the scripts in its folder. Our summary lists: Node.js.

Does Cordis Plugin Development access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cordis Plugin Development safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cordis Plugin Development use?

Cordis Plugin Development is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cordis Plugin Development use?

About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.7k tokens, read only when the agent opens those files.

What are the alternatives to Cordis Plugin Development?

Skills that share tags, products or a category with Cordis Plugin Development: Cordis Plugin Development (Zhou-Yujing114514/deepseek-harness-linux, 118 stars), Crush Configuration (charmbracelet/crush, 29k stars), Agent Setup Health Audit (tw93/Waza, 7.2k stars) and Writing Plugins (nukeop/nuclear, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cordis Plugin Development?

singula-ai (a GitHub organization) maintains it in singula-ai/alego, which has 109 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on September 28, 2026.

Source: singula-ai/alego on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.