Agent skill

Readme

by aiskillstore in aiskillstore/marketplace

When the user wants to create or update a README.md file for a project.

No licenceAuto-check: notesDevelopment

Install Readme

skills CLI
$ npx skills add aiskillstore/marketplace --skill readme -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aiskillstore/marketplace readme --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aiskillstore/marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sickn33/readme .claude/skills/readme && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
readme
GitHub stars
430
Used in
5 other repos
Token cost
~4.9k tokens
SKILL.md length
620 words
Files
2
Skills in repo
1,085
Repo updated
First seen
Licence
None found

At a glance

When the user wants to create or update a README.md file for a project.

  • Works in 12 steps: Deep Codebase Exploration → Identify Deployment Target → Ask Only If Critical → …
  • Wants to create
  • SKILL.md covers When to Use This Skill, The Three Purposes of a README, Before Writing and README Structure, plus 2 more sections
  • Reaches github.com; needs RAILS_MASTER_KEY and POSTGRES_PASSWORD

What it does

Readme is an agent skill from aiskillstore/marketplace. When the user wants to create or update a README.md file for a project. Also use when the user says 'write readme,' 'create readme,' 'document this project,' 'project documentation,' or asks for help with README.md. This skill creates absurdly thorough documentation covering local setup, architecture, and deployment.

Its SKILL.md is about 4.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill-report.json`).

It sits in Development, covering Technical documentation and Deployment. It works with Docker and Ruby. The repository describes itself as: Security-audited skills for Claude, Codex & Claude Code. One-click install, quality verified.

When your agent uses it

  • Wants to create
  • Update a README.md file for a project
  • The user says write readme
  • Document this project

Example prompts

  • “write readme,”
  • “create readme,”
  • “document this project,”
  • “/readme”

Requirements

  • Node.js
  • Docker
  • A credential in RAILS_MASTER_KEY

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Deep Codebase Exploration
  2. Identify Deployment Target
  3. Ask Only If Critical
  4. Project Title and Overview
  5. Tech Stack
  6. Prerequisites
  7. Getting Started
  8. Architecture Overview
  9. Environment Variables
  10. Available Scripts
  11. Testing
  12. Deployment

What it can do on your machine

Read from SKILL.md and the folder at commit 4ac52da. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • RAILS_MASTER_KEY
    • POSTGRES_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Readme loads about 4.9k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 620 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~4.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:183
    cp .env.example .env
  • NoteRuns commands with sudoSKILL.md:702
    sudo systemctl restart myapp
  • NoteRuns commands with sudoSKILL.md:758
    sudo apt-get install libpq-dev

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 620 words (~4,888 tokens).

“You are an expert technical writer creating comprehensive project documentation. Your goal is to write a README.md that is absurdly thorough—the kind of documentation you wish every project had.”

— opening of SKILL.md by aiskillstore
name
readme
source
https://github.com/Shpigford/skills/tree/main/readme
risk
safe

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/sickn33/readme of aiskillstore/marketplace.

  • SKILL.md
  • skill-report.json

Open the folder on GitHubat commit 4ac52da

Used in 5 other repositories

We found 14 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in aiskillstore/marketplace, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Readme next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Readme compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Readme this skillaiskillstore/marketplace4305 repos~4.9kAutomated safety check: NotesNone
1panel App Builderarch3rPro/1Panel-Appstore213—~1.3kAutomated safety check: PassMIT
Verify New Sample PRpnp/sp-dev-fx-aces139—~2kAutomated safety check: PassMIT
Sync Dependabot Pinsossf/oss-crs165—~1.7kAutomated safety check: NotesMIT
Kouchou AI Developmentdigitaldemocracy2030/kouchou-ai171—~540Automated safety check: NotesAGPL-3.0
Flowfile Config and Flags CatalogEdwardvaneechoud/Flowfile370—~12kAutomated safety check: NotesMIT

Similar skills

  • 1panel App Builder

    arch3rPro/1Panel-Appstore

    A skill your agent uses when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories…

    213 GitHub stars~1.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Verify New Sample PR

    pnp/sp-dev-fx-aces

    Verify a "new sample" PR in pnp/sp-dev-fx-aces builds successfully, then produce a deployment + testing checklist from the sample README so it can be manually deployed and tested before merging.

    139 GitHub stars~2k tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • After a Dependabot bump of oss-crs-infra/dependabot-pins.Dockerfile, resolve the human-readable version tag for each updated digest, fix the inline comment, and sync the digest to…

    165 GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Kouchou AI Development

    digitaldemocracy2030/kouchou-ai

    Local development setup, build and lint commands, environment configuration, and deployment helpers for the kouchou-ai repo.

    171 GitHub stars~540 tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Flowfile Config and Flags Catalog

    Edwardvaneechoud/Flowfile

    Catalog of Flowfile's environment variables and runtime flags: what each does, where the code reads it, its default, and where the docs disagree with the code.

    370 GitHub stars~12k tokensUpdated today
    DevelopmentAuto-check: notes
  • Genie API Service Docs

    qualcomm/qai-appbuilder

    GenieAPIService technical documentation retrieval. An agent skill from qualcomm/qai-appbuilder.

    246 GitHub stars~840 tokensUpdated today
    DevelopmentAuto-check passed

More from aiskillstore/marketplace

All 1,085 skills in this repo
  • Code Stats

    aiskillstore/marketplace

    Analyze codebase with tokei (fast line counts by language) and difft (semantic AST-aware diffs).

    430 GitHub starsUsed in 2 repos~697 tokens
    Auto-check: notes
  • Data Processing

    aiskillstore/marketplace

    Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~720 tokens
    Auto-check: notes
  • Doc Scanner

    aiskillstore/marketplace

    Scans for project documentation files (AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, CURSOR.md, WARP.md, and 15+ other formats) and synthesizes guidance.

    430 GitHub starsUsed in 1 repo~644 tokens
    Auto-check: notes
  • File Search

    aiskillstore/marketplace

    Modern file and content search using fd, ripgrep (rg), and fzf.

    430 GitHub starsUsed in 1 repo~598 tokens
    Auto-check: notes
  • Find Replace

    aiskillstore/marketplace

    Modern find-and-replace using sd (simpler than sed) and batch replacement patterns.

    430 GitHub starsUsed in 1 repo~527 tokens
    Auto-check: notes
  • Investigating Codebases

    aiskillstore/marketplace

    Automatically activated when user asks how something works, wants to understand unfamiliar code, needs to explore a new codebase, or asks questions like "where is X implemented?", "how does Y…

    430 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

Works with

Questions about Readme

What does Readme do?

When the user wants to create or update a README.md file for a project. Readme is an agent skill from aiskillstore/marketplace.md file for a project.

When should I use Readme?

Readme fits situations like: wants to create; update a README.md file for a project; the user says write readme; document this project.

How do I install Readme in Claude Code?

Run `npx skills add aiskillstore/marketplace --skill readme -a claude-code`. Or copy the skill folder (skills/sickn33/readme in aiskillstore/marketplace) into .claude/skills/readme in your project. Claude Code loads it when a task matches its description.

How do I install Readme in Codex?

Run `npx skills add aiskillstore/marketplace --skill readme -a codex`. Or copy the skill folder (skills/sickn33/readme in aiskillstore/marketplace) into .agents/skills/readme in your project. Codex loads it when a task matches its description.

Can I use Readme in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aiskillstore/marketplace --skill readme -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/readme, .gemini/skills/readme, .github/skills/readme and .opencode/skills/readme in your project.

What does Readme need to run?

Going by SKILL.md and its folder, Readme needs credentials named RAILS_MASTER_KEY and POSTGRES_PASSWORD. Our summary lists: Node.js; Docker; A credential in RAILS_MASTER_KEY.

Does Readme access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Readme safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Readme use?

No licence was found for Readme or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Readme use?

About 4.9k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Readme?

Skills that share tags, products or a category with Readme: 1panel App Builder (arch3rPro/1Panel-Appstore, 213 stars), Verify New Sample PR (pnp/sp-dev-fx-aces, 139 stars), Sync Dependabot Pins (ossf/oss-crs, 165 stars) and Kouchou AI Development (digitaldemocracy2030/kouchou-ai, 171 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Readme?

aiskillstore (a GitHub organization) maintains it in aiskillstore/marketplace, which has 430 GitHub stars. The repository holds 1,085 skills in this directory. The repository was last updated on October 7, 2026.

Source: aiskillstore/marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.