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- Fusion MCP (`mcp_fusion_skills`) should be available for full functionality
- Falls back to local skill catalog if MCP is unavailable
How to use fusion-skills
- 1.Install the skill using: npx skills add https://github.com/equinor/fusion-skills --skill fusion-skills
- 2.Clarify your intent: finding a skill, installing/updating one, creating your own, or reporting a problem
- 3.The skill will route you to the appropriate agent (discovery, greenkeeper, author, or warden)
- 4.Follow the agent's workflow to complete your task
- 5.For compound requests (e.g., inspect and fix), agents run sequentially with context passed between them
Use cases
- 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
- 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
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.
No. fusion-skills is scoped to skill lifecycle operations only. GitHub issue resolution, PR reviews, and task planning are handled by other Fusion skills.
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.
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.
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
| Intent | Agent |
|---|---|
| Find or discover the right skill; list installed skills | agents/discovery.agent.md |
| Install, update, remove, or check skills; set up automation | agents/greenkeeper.agent.md |
| Create, author, or improve a skill | agents/author.agent.md |
| Inspect a skill for quality issues, or report a skill failure | agents/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 fromapm.yml, then runapm pruneto 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.ymlandapm.lock.yamlto inspect dependency provenance and deployed-file ownership) — never edit them in place directly; route content fixes throughagents/author.agent.md(which redirects tofusion-skill-authoring, source repo) and failures throughagents/warden.agent.md(report mode).
Related skills
More from equinor/fusion-skills and the wider catalog.

fusion-code-conventions
Enforce TypeScript, React, C#, and Markdown code conventions, ADR compliance, and intent documentation.

fusion-dependency-review
Structured review workflow for dependency update PRs with security, code quality, and impact analysis.

fusion-github-review-resolution
Resolve GitHub PR review comments end-to-end: evaluate, fix, reply, and close threads automatically.

fusion-issue-authoring
Classify GitHub issues by type and draft them with type-specific structure, safety gates, and devil's-advocate review.

aws-diagrams
Visualizes AWS infrastructure from CLI output, CloudFormation, or descriptions. Use when user has AWS resources to diagram.

eraser-diagrams
Generate professional architecture diagrams from code, infrastructure, or descriptions using Eraser API.