enable-journaling

enable-journaling is a skill for Claude Code from ggemba/squad-mcp. It costs 0 tokens per session (1,239 once invoked), scanned A, original, Apache-2.0.

An optional setup for recording a small work trail when tools edit files. It saves the time, tool name, and edited path, but not file contents, in a local staging file.

In plain words
What is it for?
Use it to install the capture hooks and print the settings snippet needed to turn them on.
Why use it?
It provides activity breadcrumbs for future journaling while leaving the main workflow unchanged.

Skill for Claude Code

Written for Claude Code: PostToolUse hook event. Also seen: reads .claude/ paths; mentions Claude Code.

Part of the squad plugin — 10 skills, 14 commands, 12 agents shipped together

Good fit Use it to install the capture hooks and print the settings snippet needed to turn them on.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/ggemba/squad-mcp/enable-journaling
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add ggemba/squad-mcp --skill enable-journaling
Clone the repo
git clone --depth 1 https://github.com/ggemba/squad-mcp

Made for: Claude Code.

Or install squad, the plugin that ships this one along with the rest of its 10 skills, 14 commands, 12 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for enable-journaling

README.md
[![agentmods](https://agentmods.dev/badge/skills/ggemba/squad-mcp/enable-journaling.svg)](https://agentmods.dev/skills/ggemba/squad-mcp/enable-journaling)
Your own site
<a href="https://agentmods.dev/skills/ggemba/squad-mcp/enable-journaling"><img src="https://agentmods.dev/badge/skills/ggemba/squad-mcp/enable-journaling.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,239 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.01239
Opus 5 $0.00000 $0.00620
Sonnet 5 $0.00000 $0.00248
Haiku 4.5 $0.00000 $0.00124

Measured 8d ago against content hash 75456164f856, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

enable-journaling scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/enable-journaling/SKILL.md · 132 lines

How it starts

The opening of the file, as written. The whole thing — 132 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Skill: Enable Journaling

Objective

Help the user opt in to auto-journaling capture plumbing (PR1 / Fase 1a). This installs an opt-in Claude Code PostToolUse hook that records work-trail metadata — a timestamp, the tool name, and the edited file path — into a local staging file (.squad/pending-journal.jsonl). It captures NO file contents.

This skill does two things and nothing else:

  1. Copies the two bundled hook scripts (hooks/post-tool-use.mjs and hooks/journal-event.mjs) into the user's .squad/hooks/, chmod 0o700.
  2. Prints the exact .claude/settings.json PostToolUse snippet for the user to paste themselves.

It is capture-only. The squad's behaviour does not change as a result of enabling journaling — the captured breadcrumbs are not yet read by anything.

Inviolable Rules

  1. Never auto-write .claude/settings.json. The skill PRINTS the snippet and the user pastes it. Claude Code settings are the user's to edit — the skill never modifies them, not even with confirmation.
  2. Explicit consent before any copy. Before copying files into .squad/hooks/, confirm with the user in plain language what will be written and where. No silent file creation.
  3. No git commit, no git push. Read-only git is fine for context. The user owns the commit.
  4. No AI attribution in anything this skill writes or prints. Consistent with the squad-wide commit-authorship rule.
  5. State the scope plainly. Every run MUST tell the user, in plain words, that this is capture plumbing only and that squad behaviour will NOT change until a follow-up release (PR2) adds distillation and retrieval.

Inputs

/squad:enable-journaling

No flags. The skill is interactive — it asks for consent before writing.

Tell the user, in plain language:

  • What this installs: an opt-in PostToolUse hook that records metadata only (timestamp, tool name, edited path) to .squad/pending-journal.jsonl. It never records file contents.
  • Scope statement (mandatory): "This is capture plumbing only — squad behaviour will NOT change until a follow-up release (PR2) adds distillation and retrieval. Until then the captured breadcrumbs simply accumulate locally."
  • What gets written: two scripts copied into .squad/hooks/.
  • What does NOT get written: .claude/settings.json — the skill prints a snippet for the user to paste themselves.

Read the full file on GitHub · 132 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 132 lines · 0 tokens per session scan A 75456164f856

Subscribe to this mod's changes

enable-journaling is a skill published in the GitHub repository ggemba/squad-mcp (4 stars, last pushed 1mo ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 1,239 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

pr

Comprehensive PR/issue review - analyzes architecture, tests, identifies unrelated changes mixed in, drafts review comment or issue comment. Use when user asks to review a PR, check a PR, look at PR changes, or comment on an issue.

umputun/cc-thingz · 51 tokens

pr-threads-address

Address PR review feedback by systematically working through every unresolved PR review thread on the current branch's PR - analyze each comment, make the requested code changes (with tests where useful), commit, and optionally reply and resolve.

posit-dev/skills · 48 tokens

pr-comment

Post friendly review comments to a GitHub PR — prepare locally, preview, then submit as atomic review. Use when: posting code review comments, giving PR feedback, sending inline suggestions. Not for: reading existing reviews (use load-pr-review), creating PRs (use create-pr), PR status (use pr-summary).

sd0xdev/sd0x-harness · 67 tokens

pr-review

PR self-review — review changes, produce checklist, update rules.

sd0xdev/sd0x-harness · 15 tokens

check-pr

Read-only inspection of a single GitHub PR lifecycle — checks CI, review threads, description sync, and mergeability, and returns PASS or FAIL with per-gate findings. Never invokes the merge button. Use when verifying a PR is ready to merge, polling lifecycle progress, checking mergeability, or babysitting a GitHub PR…

doodledood/manifest-dev · 74 tokens

procoder

Work like a senior developer in a repository governed by procoder: run the commit gate before calling anything done, format and lint through the binary, and drive the spec, plan, todo, backlog, and sprint chain in .procoder/. Use this skill when the repository contains a .procoder/ directory or an AGENTS.md naming…

azrtydxb/procoder · 101 tokens