Написание README

Пишет или чинит README по реальному коду: что это за проект, рабочий быстрый старт с проверенными командами, таблица конфигурации, частые задачи и решение проблем – без выдуманных возможностей. Используйте, когда у репозитория нет README, он устарел или пользователь просит документацию проекта.

ДокументацияПак: Документация70 строкreadme-writer

Установка

Выполните одну команду — она сохранит SKILL.md в папку скиллов агента. Перезапустите агента, и он подхватит скилл сам.

Claude Code — macOS, Linux
mkdir -p ~/.claude/skills/readme-writer && curl -fsSL https://anymodel.org/en/skills/docs/readme-writer/SKILL.md -o ~/.claude/skills/readme-writer/SKILL.md
Codex, Cursor — macOS, Linux
mkdir -p ~/.agents/skills/readme-writer && curl -fsSL https://anymodel.org/en/skills/docs/readme-writer/SKILL.md -o ~/.agents/skills/readme-writer/SKILL.md
Claude Code — Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.claude\skills\readme-writer" | Out-Null; Invoke-WebRequest https://anymodel.org/en/skills/docs/readme-writer/SKILL.md -UseBasicParsing -OutFile "$HOME\.claude\skills\readme-writer\SKILL.md"
Codex, Cursor — Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.agents\skills\readme-writer" | Out-Null; Invoke-WebRequest https://anymodel.org/en/skills/docs/readme-writer/SKILL.md -UseBasicParsing -OutFile "$HOME\.agents\skills\readme-writer\SKILL.md"

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/docs/readme-writer/SKILL.md

SKILL.md

Исходник

README Writer

A README is correct only if a new person can follow it and succeed. Derive every statement from the code, and run the commands you document.

Workflow

  1. Read before writing. If a README exists, read it fully and note what is stale. Then read the manifests (package.json, pyproject.toml, go.mod, ...), entry points, Makefile or scripts, Dockerfile, CI config, .env.example, and the code that reads environment variables.
  2. Build the facts list: what the project does (from code, not from the name), required runtime versions, install, run, test and build commands, ports, config variables, external services it needs.
  3. Verify the quick start. In a clean checkout or temporary directory when possible, run the install and start commands exactly as you will write them, and confirm the result (a URL responds, a test passes, a CLI prints help). Use dummy values for configuration; never use real secrets. Ask before running anything that touches real external services or data.
  4. Write the README using the structure below, keeping only sections that apply.
  5. Re-read it as a newcomer: every command copy-pasteable, every path real, every variable listed.

Structure

# Project name
One or two sentences: what it does and for whom.

(Optional) Screenshot, diagram or short demo output.

## Requirements
Runtime versions and tools, with the versions that were tested.

## Quick start
Numbered commands, from clone to seeing it work.

## Configuration
| Variable | Required | Default | Description |

## Usage
The 3 to 5 most common tasks, each with a command and expected result.

## Development
Run tests, lint, build; project layout in a few lines.

## Troubleshooting
Symptom -> cause -> fix, for problems that really occur.

## License

Add Deployment, API or Contributing sections only if the repo has material for them. Link to longer docs instead of duplicating them.

Rules

  • No invented features, endpoints, flags or badges. If you cannot find it in the code, it is not in the README.
  • Mark anything you could not verify, for example "not tested on Windows".
  • The configuration table covers every environment variable the code reads. Find them with a search such as grep -rnE "process\.env|os\.environ|getenv" . and adapt to the language. Show example values that are obviously fake, such as your-api-key-here. Never copy real values from a .env file.
  • Commands go in fenced code blocks with the language tag. Use $-free lines so they can be pasted.
  • Prefer short sentences and concrete nouns. Skip marketing words and long feature lists that restate the code.
  • When fixing an existing README, preserve useful content and the author's structure, change only what is wrong or missing, and say what you changed.

Pitfalls

  • Copying the quick start from the old README without running it.
  • Documenting the ideal setup rather than the one that works (missing system packages, a needed database, a code generation step).
  • Leaving template leftovers: "TODO", placeholder project names, dead links.
  • Listing environment variables that no longer exist or omitting the required ones.
  • Putting real hostnames, tokens, personal emails or internal URLs in examples.

Report back

The files written or changed, the commands you verified and their results, anything you could not verify, and questions where the code did not answer (for example the intended license).

Source: AnyModel skills catalog · License: CC BY 4.0

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Документация

Документация HTTP API

Документирует HTTP-эндпоинты по реальному коду: метод, путь, авторизация, параметры, примеры запросов и ответов, коды ошибок – примеры совпадают с настоящими обработчиками. Используйте, когда у сервиса нет документации API, она устарела или пользователь просит описать API.

Запись архитектурного решения (ADR)

Пишет короткую датированную запись архитектурного решения (ADR): контекст, решение, рассмотренные варианты с компромиссами, последствия и статус, и кладёт её рядом с кодом. Используйте, когда принято или обсуждается важное техническое решение, которое нужно зафиксировать.

Чистка комментариев в коде

Чистит комментарии в коде: убирает шум, повторяющий код, сохраняет и уточняет комментарии «почему», исправляет устаревшие, которые врут, и добавляет комментарий только там, где замысел неочевиден. Используйте, когда просят привести в порядок или проверить комментарии в файле, модуле или diff.