Skip to content
Back to search

action-canvas

Agent skill that keeps a one-page action canvas for every feature branch (what, why, impact)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tobiashofmann--action-canvas/badge.svg)](/listings/tobiashofmann--action-canvas)

HTML

<a href="/listings/tobiashofmann--action-canvas"><img src="/api/listings/tobiashofmann--action-canvas/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add tobiashofmann/action-canvas

Only the `skills/action-canvas/` folder (`SKILL.md` and `render_canvas.py`) is installed; examples and tests stay in the repo.

Or copy `skills/action-canvas` to `~/.claude/skills/action-canvas` (personal) or `<project>/.claude/skills/action-canvas` (per project).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 57 lines
  1. # action-canvas
  2. [![skills.sh](https://skills.sh/b/tobiashofmann/action-canvas)](https://skills.sh/tobiashofmann/action-canvas)
  3. [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
  4. An [Agent Skill](https://docs.claude.com/en/docs/claude-code/skills) that keeps a one-page **action canvas** for every feature branch, so the requester can always see **what** is being done, **why**, and **with what impact**.
  5. The agent creates the canvas when a feature branch starts, plans it, keeps it current while it works, and finalizes it before the PR. Each canvas is a Markdown file plus a rendered SVG/PNG image.
  6. ![Example canvas](examples/feature-pdf-export.png)
  7. ## What it does
  8. - Creates `docs/action-canvas/<branch-slug>.md` with 11 fields: measure, description, background, added value, stakeholders, IT, critical success factors, resources, implementation (time horizon, complexity, cost, risk on a 1–5 scale), required activities, open points.
  9. - Asks the requester when something is not the AI's to decide, instead of guessing.
  10. - Fills IT resources only when the repo clearly shows them, and asks otherwise.
  11. - Writes the canvas, the image and its chat messages in the requester's language: English, German, Portuguese, French, Italian or Spanish.
  12. - Renders the canvas as a one-page card layout (long title on top, short measure name in the highlighted box) with a dependency-free Python script and validates required fields per phase (`start`, `plan`, `final`).
  13. ## Install
  14. ```bash
  15. npx skills add tobiashofmann/action-canvas
  16. ```
  17. Only the `skills/action-canvas/` folder (`SKILL.md` and `render_canvas.py`) is installed; examples and tests stay in the repo.
  18. Or copy `skills/action-canvas` to `~/.claude/skills/action-canvas` (personal) or `<project>/.claude/skills/action-canvas` (per project).
  19. ## Requirements
  20. - Python 3 (standard library only).
  21. - Optional, for PNG output: `pip install cairosvg` or `rsvg-convert`.
  22. ## Usage
  23. Start a feature branch and describe the feature. The skill triggers on its own. You can also run the renderer directly (in an installed skill the script sits next to `SKILL.md`, e.g. `.claude/skills/action-canvas/render_canvas.py`):
  24. ```bash
  25. python3 skills/action-canvas/render_canvas.py docs/action-canvas/feature-x.md --check plan
  26. python3 skills/action-canvas/render_canvas.py docs/action-canvas/feature-x.md --png
  27. python3 skills/action-canvas/render_canvas.py docs/action-canvas/feature-x.md --lang de # force a language
  28. ```
  29. Examples: [English](examples/feature-pdf-export.md), [German](examples/feature-pdf-export.de.md).
  30. ## Tests
  31. ```bash
  32. python3 -m unittest discover -s tests -v
  33. ```
  34. Smoke tests for the renderer (standard library only): examples pass the checks, missing fields fail, localized messages, Implementation warnings, truncation, escaping.
  35. ## License
  36. [Apache License 2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.