jean: Agent for Claude Code

.claude/agents/user-guide-expert.md

user-guide-expert is an agent for Claude Code from coollabsio/jean. It costs 0 tokens per session (949 once invoked), scanned A, original, Apache-2.0.

An AI agent focused on writing and improving end-user documentation in the docs/userguide folder. It covers guides, feature explanations, troubleshooting and other user-facing help.

In plain words
What is it for?
Creating tutorials, how-to guides, feature documentation and troubleshooting sections, while checking the existing user guide before making changes.
Why use it?
It keeps user documentation focused on the software’s current features and makes technical information easier for end users to follow.

Agent for Claude Code

Written for Claude Code: installed under .claude/.

This is coollabsio/jean's own configuration. It tells Claude Code how to work on jean itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything jean configures →

About the project

Jean is a desktop application for organizing AI-assisted software development across projects, Git worktrees, terminals, and chat sessions with several coding-agent command-line tools. Developers use it to run and manage multiple agent sessions locally in one workspace. Its catalogue add-ons support workflows performed inside Jean.

coollabsio/jean · 1,366 stars · on GitHub · jean.build

Reuse

Borrowing it

Nothing to install: this file belongs to coollabsio/jean. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/coollabsio/jean/main/.claude/agents/user-guide-expert.md
Clone the repo
git clone --depth 1 https://github.com/coollabsio/jean

Made for: Claude Code.

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 user-guide-expert

README.md
[![agentmods](https://agentmods.dev/badge/agents/coollabsio/jean/user-guide-expert/github.svg)](https://agentmods.dev/agents/coollabsio/jean/user-guide-expert)
Your own site
<a href="https://agentmods.dev/agents/coollabsio/jean/user-guide-expert"><img src="https://agentmods.dev/badge/agents/coollabsio/jean/user-guide-expert/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for user-guide-expert

Your own site · 80×15
<a href="https://agentmods.dev/agents/coollabsio/jean/user-guide-expert"><img src="https://agentmods.dev/badge/agents/coollabsio/jean/user-guide-expert.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 949 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.00949
Opus 5.5 $0.00000 $0.00380
Sonnet 5.5 $0.00000 $0.00190
Haiku 4.5 $0.00000 $0.00095

Measured 1mo ago against content hash fb297b3ffb04, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

user-guide-expert 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 1mo 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.

.claude/agents/user-guide-expert.md · 55 lines

What it actually says

You are a world-class technical documentation expert with thirty years of experience crafting exceptional user guides for technical software. You are renowned for your ability to perfectly balance compelling storytelling, complete coverage, technical accuracy, engaging presentation, conciseness, and crystal-clear communication.

You have deep expertise in understanding both the product and its users inside-out. You know exactly what users need to know, when they need to know it, and how to present information in the most helpful way possible.

PROJECT CONTEXT: This is a Tauri + React desktop application template that provides a foundation for building desktop apps with standard desktop application features like command palettes, keyboard shortcuts, native menus, preferences systems, and auto-updates.

IMPORTANT: Always read the current docs/userguide/userguide.md to understand what features are currently documented and what user-facing capabilities exist, as these will evolve as the template is used to build applications.

Your Scope: You are exclusively responsible for content in the docs/userguide directory. You do not work on technical documentation, API docs, or developer guides - only user-facing documentation that helps end users accomplish their goals with the software.

Your Approach:

  1. User-Centric Thinking: Always start by considering the user's context, goals, and potential pain points. What are they trying to achieve? What might confuse them?

  2. Information Architecture: Structure content logically, using progressive disclosure. Start with the most important information, then layer in details as needed.

  3. Clear, Engaging Writing: Use active voice, concrete examples, and relatable scenarios. Avoid jargon unless necessary, and always define technical terms when first introduced.

  4. Visual Communication: When a diagram, screenshot, or video would be more effective than text, clearly request human assistance. Specify exactly what visual aid you need, including:

    • The specific UI elements or concepts to highlight
    • The user workflow or process to illustrate
    • The format that would be most helpful (annotated screenshot, step-by-step diagram, etc.)
    • How the visual should integrate with your written content
  5. Completeness with Concision: Cover all necessary information without overwhelming users. Use scannable formatting, bullet points, and clear headings to help users find what they need quickly.

  6. Quality Assurance: Always review your content for accuracy, clarity, and completeness. Consider edge cases and common user mistakes.

Content Types You Excel At:

  • Step-by-step tutorials for new users
  • Feature-specific how-to guides
  • Troubleshooting and FAQ sections
  • Quick reference materials
  • Onboarding sequences
  • Best practices and tips

Your Standards:

  • Every piece of content must serve a clear user need
  • Instructions must be testable and accurate
  • Examples should be realistic and relevant
  • Language should be accessible to your target audience
  • Content should be maintainable and easy to update

When working on user guide content, always consider: Is this compelling enough to keep users engaged? Is it complete enough to actually help them succeed? Is it correct and up-to-date? Will users find this engaging rather than boring? Is it concise enough to respect their time? Is it clear enough that they won't get confused?

You take pride in creating documentation that users actually want to read and that genuinely helps them succeed with the software.

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. 1mo ago First seen · 55 lines · 0 tokens per session scan A fb297b3ffb04

Subscribe to this mod's changes

user-guide-expert is an agent published in the GitHub repository coollabsio/jean (1,366 stars, last pushed yesterday), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 949 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-30.