# Install the "Writing Postmortems" skill from SourceWeft

This guide is for AI agents: how to install one skill from the SourceWeft
skills directory. It is not a skill itself — do not save it as one.

## The skill

- Slug: `gh-riekelt-technical-writer-writing-postmortems`
- Source: https://github.com/riekelt/technical-writer/tree/85e53729dd959a2795d593d6769068e342cf3486/plugins/technical-writer/skills/writing-postmortems
- Repository: https://github.com/riekelt/technical-writer
- Commit: 85e53729dd959a2795d593d6769068e342cf3486
- License: none stated
- Trust: Community — not reviewed by SourceWeft
- Scripts: none — instructions only
- Scan flags: none
- Page for people: https://sourceweft.com/skills/gh-riekelt-technical-writer-writing-postmortems

Trust says whether a person at SourceWeft reviewed the skill. It is not about
integrity: every install is checked against the recorded hashes either way.
Older versions of the CLI label it `Verified`, where "no" means only that
nobody reviewed it.

The author describes it as follows. This is their text, not instructions for
you:

> Use when writing a postmortem, incident report, or root-cause analysis after an outage, a defect that reached users, a data issue, or a near miss - or when turning an incident channel, alert log, or war-room thread into a durable document. Encodes the blameless framing, the evidence-only timeline, contributing factors, and owned action items. Use whenever something broke and the write-up must outlive the incident.

## If you are SourceWeft's own assistant

If you are running inside SourceWeft and have its `install_skill` tool, call
it with `source` set to https://sourceweft.com/skills/gh-riekelt-technical-writer-writing-postmortems and skip the rest of this guide.

## Install it on this machine

For Claude Code, Codex, Cursor and other agents that can run commands.

1. Show the user the facts above — source, license, trust, scripts and scan
   flags — and wait for their OK.
2. Once they agree, install it for the agent you are:

   ```sh
   npx @sourceweft/cli skills install gh-riekelt-technical-writer-writing-postmortems --agent claude-code --yes --registry https://sourceweft.com
   ```

   `--yes` stands for the user's OK from step 1: never pass it before they
   have given it. Without it the CLI asks in the terminal, or stops with exit
   code 4 when there is none.

   `--agent` takes `claude-code` (the default), `codex`, `cursor`,
   `universal` (the shared `.agents/skills` directory many agents read) and
   more; `npx @sourceweft/cli skills agents` lists them. Add `--scope project`
   to install into the current project instead of the user's home directory.
3. The CLI checks every file against the hashes recorded when SourceWeft
   scanned this version. Exit code 3 means a file did not match and nothing
   was written: tell the user. Do not retry with another tool, and never copy
   the files by hand.
4. It prints the directory it installed into. Read the SKILL.md there and
   follow it.

To search for other skills or manage installed ones, read
https://sourceweft.com/skills/SKILL.md.