How to install fusion-skills
npx skills add https://github.com/equinor/fusion-skills --skill fusion-skillsFull 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. You can safely remove it:npx -y skills remove <deprecated-skill-name>"
Safety
- No secrets or credentials.
- No GitHub mutations without confirmation.
- No remote script execution.
- No invented skill names or catalog results.
Related skills
More from equinor/fusion-skills and the wider catalog.

fusion-code-conventions
Applies and explains code conventions across TypeScript, React, C#, and Markdown. Enforces naming rules, file naming patterns, TSDoc and XML doc standards, inline comment intent (the *why*, not the *what*), code structure, error handling, async patterns, and dead code policy. Also enforces ADR and contributor doc decisions, and flags decisions that appear stale or misaligned with current tooling. USE FOR: convention questions, code review against project standards, applying naming rules, auditing intent comments, checking TSDoc completeness, enforcing recorded ADR decisions, and flagging stale architectural decisions. DO NOT USE FOR: security vulnerability scanning, performance profiling, runtime debugging, or generating net-new code without a review target.

fusion-dependency-review
Review dependency PRs with structured research, existing-PR-discussion capture, multi-lens analysis (security, code quality, impact), and a repeatable verdict template. USE FOR: dependency update PRs, Renovate/Dependabot PRs, library upgrade reviews, "review this dependency PR", "should we merge this update". DO NOT USE FOR: feature PRs, application code reviews, dependency automation/bot configuration, or unattended merge without confirmation.

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

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.