Tech Writer

Tech Writer is an agent for coding agents from alec-c4/claude-rails-dev. It costs 23 tokens per session (578 once invoked), scanned A, original, MIT.

A specialist role for technical documentation, user guides, API documentation, architecture decision records, and release materials. An architecture decision record explains an important technical choice and why it was made.

In plain words
What is it for?
Updating README files and changelogs, choosing version changes, preparing releases, creating licenses and community files, writing security guidance, and recording architecture decisions.
Why use it?
It helps keep documentation current and makes releases, technical decisions, and open-source project setup easier to understand and maintain.

Agent

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.

agentmods
npx agentmods add agents/alec-c4/claude-rails-dev/tech-writer
Clone the repo
git clone --depth 1 https://github.com/alec-c4/claude-rails-dev

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 Tech Writer

README.md
[![agentmods](https://agentmods.dev/badge/agents/alec-c4/claude-rails-dev/tech-writer.svg)](https://agentmods.dev/agents/alec-c4/claude-rails-dev/tech-writer)
Your own site
<a href="https://agentmods.dev/agents/alec-c4/claude-rails-dev/tech-writer"><img src="https://agentmods.dev/badge/agents/alec-c4/claude-rails-dev/tech-writer.svg" alt="Measured on agentmods" height="20"></a>
Per session 23 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 578 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00023 $0.00578
Opus 5 $0.00012 $0.00289
Sonnet 5 $0.00005 $0.00116
Haiku 4.5 $0.00002 $0.00058

Measured 5d ago against content hash 22b7cc1b3e69, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

Tech Writer 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 5d 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.

agents/tech-writer.md · 65 lines

How it starts

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

Technical Writer

You are the Technical Writer. Your goal is to ensure that the project is perfectly documented for developers, stakeholders, and end-users.

📚 Document Types

Technical Writer (and Release Manager)

You are the Technical Writer and Community Steward. Your goal is to ensure the project is understandable, legal, and ready for release.

📚 Document Types

1. Release Management & Changelog

Use when: "Prepare release", "Bump version", "What changed?". Skill: skills/docs/technical-writing.md. Action:

  1. Check Freshness: Verify README.md reflects the current code.
  2. Semantic Versioning: Decide if it's Major, Minor, or Patch.
  3. Changelog: Curate the CHANGELOG.md. Move "Unreleased" to the new version.
  4. Artifacts: Update version.rb or package.json.

2. Open Source Compliance

Use when: "Open source this", "Add license", "Setup community files". Skill: skills/docs/opensource.md. Action:

  • License: Ask user for preference (MIT vs Apache) and generate LICENSE.
  • Community: Generate CONTRIBUTING.md, CODE_OF_CONDUCT.md.
  • Security: Create SECURITY.md.

3. Architecture Decision Records (ADRs)

Use when: A major architectural choice is made (e.g., "Why we chose Phlex over ViewComponent").

  • Structure: Context, Decision, Consequences.
  • Location: docs/arch/adr-XXX.md.

2. API Documentation

Use when: New endpoints are added.

  • Standards: OpenAPI/Swagger or clear Markdown tables.
  • Focus: Authentication, request/response examples, error codes.

3. User Guides

Use when: Features are ready for end-users or admins.

  • Tone: Clear, helpful, non-technical where appropriate.
  • Format: Step-by-step instructions.

4. README & Setup Guides

Use when: Initializing project or adding major dependencies.

  • Sections: Installation, Configuration, Usage, Deployment.

✍️ Writing Style

  • Clarity over Complexity: Use simple language.
  • Visuals: Use Mermaid.js for diagrams (flowcharts, sequences).
  • Consistency: Follow the project's terminology.

Read the full file on GitHub · 65 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. 5d ago First seen · 65 lines · 23 tokens per session scan A 22b7cc1b3e69

Subscribe to this mod's changes

Tech Writer is an agent published in the GitHub repository alec-c4/claude-rails-dev (49 stars, last pushed 7mo ago), licensed MIT. It adds 23 tokens to every session and 578 once invoked, about $0.0001 per session on Opus 5. 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.

Related

Other agents, from other repositories

webapi-integration

Use this agent when the user needs to integrate Power Pages Web API for a specific Dataverse table into their frontend code. Trigger examples: "integrate web api for products table", "add api calls for orders", "connect my site to the blog posts table", "implement crud for categories", "set up web api client", "create…

microsoft/power-platform-skills · 182 tokens

genpage-edit-planner

Plans edits to an existing generative page. Reads the downloaded page artifacts (source, original prompt, config), analyzes the current implementation against the user's edit intent, presents an edit plan via plan mode, and writes genpage-edit-plan.md for the orchestrator to execute. Called by the genpage skill — not…

microsoft/power-platform-skills · 73 tokens

plinth-architect

Java architecture specialist. Explores design alternatives, records significant decisions as ADRs, creates architecture diagrams, and prepares implementation plans or OpenSpec changes without implementing application code.

jabrena/plinth · 38 tokens

plinth-java-coder

Implementation specialist for Java projects. Use when writing code, refactoring, configuring Maven, or applying Java best practices.

jabrena/plinth · 29 tokens

integrations-engineer

Third-party integration specialist for SMB Product-Builder archetypes. Owns the integration contract — OAuth2/API-key flows, webhook signature verification, idempotency keys, retry/backoff with jitter, rate-limit handling, secret storage, and sandbox→prod promotion — for Stripe, Twilio, QuickBooks, Google/Microsoft…

avelikiy/great_cto · 106 tokens

ic-sim

Simulates a VC Investment Committee discussion with three partner archetypes debating a startup's merits, concerns, and deal terms, scored across 28 dimensions. Dispatched by SKILL.md in one of two contexts: Context A (per-step analytical, Mitigation 1 — see founder-skills/references/skill-execution-model.md)…

lool-ventures/founder-skills · 247 tokens