PluginBench
Skill
Review
Audit score 70

fusion-skills

equinor/fusion-skills

Entrypoint for Fusion skill lifecycle: discover, install, update, author, and maintain skills.

What is fusion-skills?

fusion-skills is the orchestrator for all Fusion skill operations. Use it to find and install skills, manage updates and synchronization, create new skills, or report issues. It routes requests to specialized agents and integrates with the Fusion MCP for skill discovery and lifecycle management.

  • Discover and search for skills by description or task using semantic search
  • Install, update, remove, or check the status of installed skills
  • Set up skill automation and synchronization workflows
  • Create, author, and improve new skills with guided workflows
  • Inspect skills for quality issues and report failures or bugs
  • Route requests to the appropriate specialized agent based on intent

How to install fusion-skills

npx skills add https://github.com/equinor/fusion-skills --skill fusion-skills
Prerequisites
  • Fusion MCP (`mcp_fusion_skills`) should be available for full functionality
  • Falls back to local skill catalog if MCP is unavailable
Claude Code
Cursor
Windsurf
Cline

How to use fusion-skills

  1. 1.Install the skill using: npx skills add https://github.com/equinor/fusion-skills --skill fusion-skills
  2. 2.Clarify your intent: finding a skill, installing/updating one, creating your own, or reporting a problem
  3. 3.The skill will route you to the appropriate agent (discovery, greenkeeper, author, or warden)
  4. 4.Follow the agent's workflow to complete your task
  5. 5.For compound requests (e.g., inspect and fix), agents run sequentially with context passed between them

Use cases

Good for
  • Finding the right skill to solve a specific problem in your workflow
  • Installing or updating a skill and setting up automation for skill management
  • Creating a new custom skill from scratch or improving an existing one
  • Diagnosing and reporting bugs or quality issues with an installed skill
  • Listing and managing your current skill inventory
Who it's for
  • Fusion platform users managing their skill ecosystem
  • Developers authoring or maintaining custom skills
  • Teams setting up skill automation and synchronization
  • Users troubleshooting skill failures or performance issues

fusion-skills FAQ

What's the difference between fusion-skills and the deprecated fusion-discover-skills?

fusion-skills is the unified entrypoint that replaces deprecated skills like fusion-discover-skills and fusion-skill-self-report-bug. If you have those installed, remove them from apm.yml and run apm prune to reconcile.

Can I use this skill to resolve GitHub issues or review pull requests?

No. fusion-skills is scoped to skill lifecycle operations only. GitHub issue resolution, PR reviews, and task planning are handled by other Fusion skills.

What happens if Fusion MCP is not available?

The skill falls back to a local skill catalog (references/skill-catalog.md) and will prompt you to enable Fusion MCP when it becomes available for better functionality.

Can I edit installed skill files directly?

No. Installed skill files are copies managed by apm.yml and apm.lock.yaml. Route content fixes through the author agent (which redirects to fusion-skill-authoring) and report failures through the warden agent.

How do I report a bug with a skill?

Use the warden agent by describing the skill failure or quality issue. The skill will guide you through the reporting workflow without requiring direct GitHub mutations.

Full instructions (SKILL.md)

Source of truth, from equinor/fusion-skills.


name: fusion-skills description: 'Entrypoint for all Fusion skill lifecycle operations. USE FOR: finding, installing, updating, syncing, or greenkeeping skills; setting up skill automation; creating or authoring a new skill; reporting a bug with a skill. DO NOT USE FOR: resolving GitHub issues, reviewing PRs, planning task breakdowns, or authoring GitHub issues — those are handled by other Fusion skills.' license: MIT compatibility: Assumes Fusion MCP is available (mcp_fusion_skills). Falls back to references/skill-catalog.md and promotes Fusion MCP when unavailable. metadata: version: "0.0.0" status: active owner: "@equinor/fusion-core" role: orchestrator skills: - agents/discovery.agent.md - agents/greenkeeper.agent.md - agents/author.agent.md - agents/warden.agent.md tags: - fusion - skills - discovery - install - sync - authoring - mcp - workflow - automation - triage - entrypoint mcp: suggested: - mcp_fusion_skills

Fusion Skills

Skill lifecycle entrypoint. Resolve intent, engage the right agent.

Loading behavior

Load ONLY the routed agent file. References are loaded on-demand by the agent when it needs them (e.g., skill-catalog.md only on MCP failure, sync-workflows.md only in setup mode). Do not preload all agents or all references.

MCP tools

This skill uses mcp_fusion_skills — the Fusion MCP tool that handles both skill discovery and lifecycle operations:

  • Discovery (intent: query): semantic search over the skills index by description or task.
  • Inventory (intent: inventory): list installed skills.
  • Lifecycle (intent: install | update | remove): advisory commands for managing skills.

Routing

IntentAgent
Find or discover the right skill; list installed skillsagents/discovery.agent.md
Install, update, remove, or check skills; set up automationagents/greenkeeper.agent.md
Create, author, or improve a skillagents/author.agent.md
Inspect a skill for quality issues, or report a skill failureagents/warden.agent.md

If the user was routed here from the fusion main gate with a partially-resolved intent (e.g., "skills"), proceed directly to the most likely agent without re-asking the top-level question.

If intent is genuinely unclear and the user was not already asked a clarifying question, ask one question: "Are you looking to find a skill, install or update one, create your own, or report a problem with one?"

Compound intents: If the request spans multiple agents (e.g., "inspect this skill and fix the issues"), run agents sequentially. Pass the output of the first agent as context to the second.

Loop prevention: If you were activated from the fusion main gate, do not redirect back to fusion. Handle the request within your agents or state that it is out of scope.

Out of scope: Resolving GitHub issues, reviewing PRs, planning task breakdowns, or authoring GitHub issues. Direct the user to the relevant installed skill or the fusion main gate — but never re-route back to fusion if you were activated from there.

Migration from deprecated skills

If fusion-discover-skills or fusion-skill-self-report-bug is installed alongside this skill, tell the user:

"You have a deprecated skill installed that's now part of fusion-skills. Remove its dependency from apm.yml, then run apm prune to reconcile the lockfile and deployed files."

Safety

  • No secrets or credentials.
  • No GitHub mutations without confirmation.
  • No remote script execution.
  • No invented skill names or catalog results.
  • Installed skill files are copies (use apm.yml and apm.lock.yaml to inspect dependency provenance and deployed-file ownership) — never edit them in place directly; route content fixes through agents/author.agent.md (which redirects to fusion-skill-authoring, source repo) and failures through agents/warden.agent.md (report mode).