terminal-output SKILL.md skillA

terminal-output from swamp-club/swamp is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add swamp-club/swamp/terminal-output@git:20261024.9c4005a

Pins git:20261024.9c4005a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
swamp-club/swamp
Path
.claude/skills/terminal-output/SKILL.md
Versions recorded
5
Latest version
git:20261024.9c4005a, committed Oct 24, 2026
First version recorded
Apr 4, 2026
Size
8,280 bytes
Repository stars
691
License
a license file GitHub does not identify

Terminal output design system for swamp CLI commands. Use when creating or modifying any CLI command output, render function, or presentation layer code. Ensures consistent formatting, coloring, and structure across all swamp commands in both "log" (human-readable) and "json" (structured) output modes. Triggers on output files in src/presentation/output/, render functions, writeOutput usage, OutputMode handling, or any CLI command that produces terminal output.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Terminal Output Design System

Consistent, human-readable terminal output for the swamp CLI.

## Two Output Modes

Every command **must** support both modes, controlled by `--json` flag:

- `"log"` (default) - Clean, colored, human-readable plain text
- `"json"` - Structured JSON for scripting and automation

The mode is available as `ctx.outputMode` from `createContext()` in
`src/cli/context.ts`.

## Which Stream

**stdout is the command's output. stderr is interaction and diagnostics.**

| Goes to stdout                       | Goes to stderr                    |
| ------------------------------------ | --------------------------------- |
| `writeOutput()` prose (log mode)     | Interactive prompts               |
| `console.log(JSON…)` (json mode)     | Spinners and progress indicators  |
| A command's bare _value_ (see below) | LogTape records, warnings, errors |

A few commands put a **value** on stdout — something a caller pipes, captures or
redirects, not prose about the result:

- `swamp invite link` and `swamp first-rule` — the URL, for `| pbcopy`
- `swamp vault read-secret` — the secret bytes, for `> key.pem`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add swamp-club/swamp/terminal-output@sha256:6081502eb9ebe929

The line at the top of this page pins the label git:20261024.9c4005a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_4rc3unizbxzjzufp.svg)](https://markdownregistry.com/a/art_4rc3unizbxzjzufp)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Apr 4, 2026 and Oct 24, 2026, about one every 51 days.

versioncommittedcommitsizeaudit
git:20261024.9c4005a latest2026-10-24 9c4005a 8,280 BA view · diff
git:20260923.89746642026-09-23 8974664 8,357 BA view · diff
git:20260918.85621c22026-09-18 85621c2 7,694 BA view · diff
git:20260613.f32c9a52026-06-13 f32c9a5 6,046 BA view · diff
git:20260404.41058542026-04-04 4105854 5,921 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8280 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

swamp-club/swamp · 691 stars · license a license file GitHub does not identify · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_4rc3unizbxzjzufp
GET https://markdownregistry.com/api/v1/resolve?ref=swamp-club/swamp/terminal-output
GET https://markdownregistry.com/api/v1/blob/6081502eb9ebe929a6710d0bb250402ce999c69076deffd7fff2147f560ea093

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from swamp-club/swamp

jujutsu SKILL.md skill
swamp-club/swamp · .agents/skills/jujutsu/SKILL.md · Track changes, rebase modifications, resolve conflicts, and manage bookmarks with Jujutsu (jj). Use when committing…
git:20260128.81e56ac · audit A · 691 stars
skill-creator SKILL.md skill
swamp-club/swamp · .agents/skills/skill-creator/SKILL.md · Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an…
git:20260128.81e56ac · audit A · 691 stars
ddd SKILL.md skill
swamp-club/swamp · .claude/skills/ddd/SKILL.md · Domain Driven Design guidance for TypeScript/Deno codebases. Apply when writing or modifying code to choose appropriate…
git:20260916.b07863c · audit A · 691 stars
github-pr SKILL.md skill
swamp-club/swamp · .claude/skills/github-pr/SKILL.md · Create and manage GitHub pull requests. Supports both jujutsu (jj) and git version control. Use when submitting PRs…
git:20260922.a17eea0 · audit A · 691 stars
issue-lifecycle SKILL.md skill
swamp-club/swamp · .claude/skills/issue-lifecycle/SKILL.md · Drive the @swamp/issue-lifecycle model for interactive issue triage and plan iteration against swamp-club lab issues…
git:20261021.bf8aaa3 · audit A · 691 stars
swamp-getting-started SKILL.md skill
swamp-club/swamp · .claude/skills/swamp-getting-started/SKILL.md · Interactive getting-started walkthrough for new swamp users. Guides through understanding the user's goals, creating…
git:20261030.a2f815f · audit A · 691 stars
swamp SKILL.md skill
swamp-club/swamp · .claude/skills/swamp/SKILL.md · Swamp CLI — create and run behaviors (formerly models), build and validate workflows, query and manage data, store and…
git:20261030.a2f815f · audit A · 691 stars
AGENTS.md AGENTS.md file
swamp-club/swamp · AGENTS.md
git:20261023.ae0d036 · audit A · 691 stars
CLAUDE.md CLAUDE.md file
swamp-club/swamp · CLAUDE.md
git:20261020.b7790f6 · audit A · 691 stars

Every file in swamp-club/swamp

Browse by kind, by grade A, or by owner.