Home / serejaris / personal-corp-os · skills/readme-generator/SKILL.md · GitHub

readme-generator skillA

readme-generator is agent-read markdown (skill) from serejaris/personal-corp-os: Use when creating or rewriting README.md for projects. Triggers on "write README", "create README", "update README". Creates human-focused documentation with proper structure..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# README Generator

Generate human-focused README files following current best practices.

**Core principle:** README is for humans, not agents. Research → Analyze → Write.

**Model recommendation:** Use `Task` tool with `model: haiku` for README generation — faster and cheaper for documentation tasks.

## When to Use

- Creating README for new project
- Rewriting outdated README
- User asks "write/create/update README"

## Process

```dot
digraph readme_flow {
    rankdir=TB;
    "1. Research best practices via Exa" [shape=box];
    "2. Analyze project structure" [shape=box];
    "3. Identify project type" [shape=diamond];
    "4. Write README with appropriate sections" [shape=box];
    "5. Commit and push if requested" [shape=box];

    "1. Research best practices via Exa" -> "2. Analyze project structure";
    "2. Analyze project structure" -> "3. Identify project type";
    "3. Identify project type" -> "4. Write README with appropriate sections";
    "4. Write README with appropriate sections" -> "5. Commit and push if requested";
}
```

## Step 1: Research

**Always search first** for current README best practices:

```
…

Read the whole file at its exact version.

How to install

Latest version
mdr add serejaris/personal-corp-os/readme-generator@git:20260111.6993e7a
Exact content
mdr add serejaris/personal-corp-os/readme-generator@sha256:198a04d31d6ba1c7

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vc3lqntfbnjhjkgl.svg)](https://markdownregistry.com/a/art_vc3lqntfbnjhjkgl)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260111.6993e7a latest2026-01-11 6993e7a 4,843 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4843 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

serejaris/personal-corp-os · 228 stars · license MIT · pushed 2026-09-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vc3lqntfbnjhjkgl
GET https://markdownregistry.com/api/v1/resolve?ref=serejaris/personal-corp-os/readme-generator
GET https://markdownregistry.com/api/v1/blob/198a04d31d6ba1c799bc1fa1995f5367cde892011e6496113feedd7f83ce50eb

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from serejaris/personal-corp-os

AGENTS.md agents
serejaris/personal-corp-os · AGENTS.md
git:20260806.efbc2a2 · audit A · 228 stars
CLAUDE.md claude
serejaris/personal-corp-os · CLAUDE.md
git:20260603.c9c1389 · audit B · 228 stars
paperclip-api skill
serejaris/personal-corp-os · archive/skills/paperclip-api/SKILL.md · Use when managing Paperclip AI agent companies - creating tasks, managing agents, approving hires, running heartbeats…
git:20260603.c9c1389 · audit B · 228 stars
art-director skill
serejaris/personal-corp-os · skills/art-director/SKILL.md · Orchestrate iterative visual style searches with branch prompts, decision graphs, feedback loops, and final direction…
git:20260601.60affe7 · audit B · 228 stars
cc-analytics skill
serejaris/personal-corp-os · skills/cc-analytics/SKILL.md · Use when user asks for Claude Code usage stats, weekly analytics, project activity summary, or wants to see what…
git:20260116.7a128a7 · audit A · 228 stars
ceo-council skill
serejaris/personal-corp-os · skills/ceo-council/SKILL.md · Use when needing strategic project analysis from multiple independent expert perspectives. Triggers on business…
git:20260223.51e846c · audit A · 228 stars
claude-md-writer skill
serejaris/personal-corp-os · skills/claude-md-writer/SKILL.md · Use when creating or refactoring CLAUDE.md files - enforces best practices for size, structure, and content organization
git:20260806.fd3a777 · audit A · 228 stars
corp-doctor skill
serejaris/personal-corp-os · skills/corp-doctor/SKILL.md · Use when a Personal Corp operating loop needs setup, repair, a new department, or task routing: HQ files and agent…
git:20260806.3f37f87 · audit A · 228 stars
fable-ruki-agenty skill
serejaris/personal-corp-os · skills/fable-ruki-agenty/SKILL.md · Фейбл руки-агенты — ручной режим оркестрации, где Fable не пишет код, а пишет спеки в тела GH issues и раздаёт готовые…
git:20260806.30c265a · audit A · 228 stars
gh-issues skill
serejaris/personal-corp-os · skills/gh-issues/SKILL.md · Use when creating, searching, updating, or managing GitHub issues via CLI. Triggers: "issue", "create issue", "gh…
git:20260111.6993e7a · audit A · 228 stars
grill-me skill
serejaris/personal-corp-os · skills/grill-me/SKILL.md · Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of…
git:20260701.d165932 · audit A · 228 stars
html-draft skill
serejaris/personal-corp-os · skills/html-draft/SKILL.md · Use when user wants a standalone HTML diagram in flat engineering blueprint style — architecture diagrams, system…
git:20260602.cf8f697 · audit B · 228 stars

Every file in serejaris/personal-corp-os

Browse by kind, by grade A, or by owner.