readme-agents-writer
README/AGENTS/CLAUDE Writer
Mission
Produce documentation that works for both humans and coding agents:
- Keep the 3-file schema strict (
README.md,AGENTS.md,CLAUDE.md). - Keep the instruction quality high enough for autonomous execution (guardrails, conventions, playbooks, do/don't rules, verification steps, and escalation rules).
- Keep guidance agent-agnostic: no model/vendor-specific logic unless a separate compatibility note is unavoidable.
If AGENTS.md and CLAUDE.md symlink to README.md, the README is no longer "just a project readme"; it is the full operational source of truth.
When To Use
- Creating or updating documentation triplets (
README.md,AGENTS.md,CLAUDE.md) - Converting dedicated
AGENTS.md/CLAUDE.mdfiles to symlinked companions - Refactoring large docs while keeping agent guidance accurate, explicit, and current
- Strengthening weak instruction files that are vague, stale, or hard for agents to execute safely
More from wottpal/skills
date-fns
Practical workflow for date-fns v4 and native @date-fns/tz usage, covering imports, parsing/formatting, calculations, timezone-safe patterns, and common pitfalls.
50jotai-nextjs
Expert workflow for Jotai state management with a Next.js focus, covering core APIs, SSR hydration, utilities, recipes, and current release migrations.
10use-the-index-luke
Postgres query and index optimization workflow based on use-the-index-luke principles. Use for EXPLAIN analysis, index design, predicate rewrites, joins, sorting, and pagination tuning.
8deep-research-firecrawl
Conducts citation-backed research using Firecrawl MCP search, scrape, map, crawl, and agent tools with selectable quick, standard, deep, and ultradeep modes. Use for multi-source comparisons, technical evaluations, market research, and high-stakes decision support.
8slack-web-api
Use when you need to read or act on Slack data via the Slack Web API (post messages, search, list channels, fetch channel history/threads, add/remove reactions). Provides a Bun+TypeScript CLI wrapper around @slack/web-api for deterministic queries and structured JSON output.
4worktree-handoff
Safely hand off the current source worktree state, including untracked files, onto a local target branch (default `develop`) without modifying the source worktree, using an alternate-index snapshot and target-side cherry-pick.
2