Skip to content

Use Affectra's workflows

Affectra writes down the workflows that work well with its tools, so you don’t have to write the instructions yourself. Each workflow tells your assistant which tools to call, in which order, and what to answer. You get each one two ways:

  • As a prompt from Affectra’s MCP server. Your assistant lists it once it is connected to Affectra. Nothing to install.
  • As an Agent Skill, a SKILL.md file that you install in your assistant. It then picks the workflow on its own when your question fits.

Both are the same text. A workflow grants nothing: each tool it calls still checks your role.

Workflow What it does You give Lowest role Skill file
Assess a release Checks a release’s open findings against the source code in your repository and proposes VEX statements where the code is clear. See Assess findings with your source code. the release Member assess-release
Investigate a vulnerability Finds the releases and units a vulnerability reaches, and what you already said about it. the vulnerability Viewer investigate-vulnerability
Triage a product Ranks a product’s findings and says what to look at first. the product or a release Viewer triage-product
Prepare a review Summarizes the pending proposals, their evidence and explanations, for the person who decides them. optionally, a release Viewer review-proposals

Pick the prompt from the Affectra server and fill in its argument:

  • Claude Code: type /mcp__affectra__ and choose, for example /mcp__affectra__triage_product edge-gateway.
  • Claude and other assistants: look for the Affectra server’s prompts. Most MCP clients show them next to the server’s tools.

MCP server lists the prompt names and arguments.

A skill is a folder with one SKILL.md file. For Claude Code, put it in ~/.claude/skills/ for yourself, or in .claude/skills/ in a repository for everyone who works there:

Terminal window
for skill in assess-release investigate-vulnerability triage-product review-proposals; do
mkdir -p ~/.claude/skills/$skill
curl -fsSL https://docs.affectra.eu/skills/$skill/SKILL.md -o ~/.claude/skills/$skill/SKILL.md
done

For another assistant that reads Agent Skills, such as Codex, put the folders where it looks for skills. Its documentation names the place.

The assistant still needs the Affectra server connected: the skill only tells it what to do with Affectra’s tools. Download the files again after an Affectra release to get the current workflows. The prompts are always current.

The workflows treat text from SBOMs and advisories as data, and the assess workflow asks before it runs a command, changes a file or files a proposal. Keep your assistant asking for these, as Assess findings with your source code describes.