Agent skill

Readme Showcase

by bagofwords1 in bagofwords1/bagofwords

Build or refresh a product README showcase using a seeded Bag of Words workspace, polished in-product screenshots, and repository-ready visual assets.

Custom licenceAuto-check passedDevelopment

Install Readme Showcase

skills CLI
$ npx skills add bagofwords1/bagofwords --skill readme-showcase -a claude-code

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

GitHub CLI
$ gh skill install bagofwords1/bagofwords readme-showcase --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/bagofwords1/bagofwords.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/readme-showcase .claude/skills/readme-showcase && 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-showcase
GitHub stars
459
Token cost
~1.8k tokens
SKILL.md length
985 words
Files
2
Skills in repo
13
Repo updated
First seen
Licence
Custom licence

At a glance

Build or refresh a product README showcase using a seeded Bag of Words workspace, polished in-product screenshots, and repository-ready visual assets.

  • Works in 5 steps: Define the Story → Build the Demo Workspace → Capture Clean Product States → …
  • Positioning has changed
  • SKILL.md covers Ground Rules, Workflow and Verification
  • Calls git

What it does

Readme Showcase is an agent skill from bagofwords1/bagofwords. Build or refresh a product README showcase using a seeded Bag of Words workspace, polished in-product screenshots, and repository-ready visual assets. Use when positioning has changed, README screenshots are stale, a launch/demo workspace is needed, or the user asks to populate agents, reports, dashboards, evals, automations, connectors, or monitoring for product storytelling.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development, covering Technical documentation, LLM evaluation and Storytelling. The repository describes itself as: Chat with your data - with memory, rules, and observability built in. Deploy in 2 minutes.

When your agent uses it

  • Positioning has changed
  • README screenshots are stale
  • A launch/demo workspace is needed
  • The user asks to populate agents

Example prompts

  • “/readme-showcase”

Workflow steps

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

  1. Define the Story
  2. Build the Demo Workspace
  3. Capture Clean Product States
  4. Add Painted Backdrops
  5. Update the README

What it can do on your machine

Read from SKILL.md and the folder at commit f227059. 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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Readme Showcase loads about 1.8k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 985 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 985 words (~1,842 tokens).

“Create a credible demo workspace first, then capture the product as it actually works. Treat the README copy, seeded state, and screenshots as one deliverable.”

— opening of SKILL.md by bagofwords1, Custom licence
name
readme-showcase

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/readme-showcase of bagofwords1/bagofwords.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit f227059

Compare with similar skills

Readme Showcase 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 Showcase compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Readme Showcase this skillbagofwords1/bagofwords459—~1.8kAutomated safety check: PassCustom licence
Get API Docs with chubandrewyng/context-hub14k1 repos~775Automated safety check: PassMIT
Adk Sample Creatorgoogle/adk-python22k—~1.3kAutomated safety check: PassApache-2.0
Create SkillHyk260/PureChat5461 repos~823Automated safety check: PassMIT
Env And Assets Bootstraplllllllama/RigorPilot-Skills4971 repos~592Automated safety check: PassMIT
Cxas Agent FoundryGoogleCloudPlatform/cxas-scrapi107—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Get API Docs with chub

    andrewyng/context-hub

    Fetches current documentation for third-party APIs and SDKs with the chub CLI before the agent writes code against them, instead of relying on remembered API shapes.

    14k GitHub starsUsed in 1 repo~775 tokens
    DevelopmentAuto-check passed
  • Adk Sample Creator

    google/adk-python

    Official

    Creates a new sample agent in the ADK Python repository — the sample directory, its agent.py, and its README.md — following the conventions the existing samples already use.

    22k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Create Skill

    Hyk260/PureChat

    Create a new skill in the current repository. An agent skill from Hyk260/PureChat.

    546 GitHub starsUsed in 1 repo~823 tokens
    DevelopmentAuto-check passed
  • Env And Assets Bootstrap

    lllllllama/RigorPilot-Skills

    Rigor Setup skill for README-first deep learning repo reproduction.

    497 GitHub starsUsed in 1 repo~592 tokens
    DevelopmentAuto-check passed
  • Cxas Agent Foundry

    GoogleCloudPlatform/cxas-scrapi

    End-to-end GECX/CXAS/CES conversational agent lifecycle -- build agents from requirements (PRD-to-agent), create and run evals (goldens, simulations, tool tests, callback tests), debug failures, and…

    107 GitHub stars~2.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Add Benchmark

    ai-twinkle/Eval

    為 Twinkle Eval 新增一個評測 benchmark(IFEval、BFCL、RAGAS、Text2SQL、Vision MCQ 之類)。涵蓋 CLAUDE.md §6 的完整強制流程:先建 Milestone 與 6 個 Issue、準備 example dataset、實作 Extractor + Scorer 並註冊 PRESETS、與參考框架做分數與速度對比、撰寫…

    117 GitHub stars~1.8k tokensUpdated 24 days ago
    AI & LLM EngineeringAuto-check passed

More from bagofwords1/bagofwords

All 13 skills in this repo
  • UI Audit

    bagofwords1/bagofwords

    Exhaustively audit the UI control by control and role by role — enumerate every button, link, and input on a set of pages, write down what each is supposed to do (derived from the handler code and…

    459 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Add Connection Type

    bagofwords1/bagofwords

    Add a new data source / connection type (e.g. An agent skill from bagofwords1/bagofwords.

    459 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Add LLM Provider Or Model

    bagofwords1/bagofwords

    Add a new LLM model to the preset catalog, or a whole new LLM provider — with the mandatory pre-flight verification of model id, pricing, and context window against the provider's official docs.

    459 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Docs Update

    bagofwords1/bagofwords

    Update the product docs at docs.bagofwords.com (Mintlify) with text and fresh screenshots after a user-facing change ships.

    459 GitHub stars~746 tokensUpdated today
    Auto-check passed
  • Localization

    bagofwords1/bagofwords

    The locale/i18n architecture of bagofwords — catalogs, resolution order, RTL, backend contracts — and the procedures for adding strings, adding a locale, or translating UI.

    459 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • QA

    bagofwords1/bagofwords

    Run a live QA pass over the app — first map all user-facing functionality, then boot the full stack and manually exercise flows with Playwright, recording pass/fail evidence and filing a QA report.

    459 GitHub stars~824 tokensUpdated today
    Auto-check passed

Questions about Readme Showcase

What does Readme Showcase do?

Build or refresh a product README showcase using a seeded Bag of Words workspace, polished in-product screenshots, and repository-ready visual assets. Readme Showcase is an agent skill from bagofwords1/bagofwords. Build or refresh a product README showcase using a seeded Bag of Words workspace, polished in-product screenshots, and repository-ready visual assets.

When should I use Readme Showcase?

Readme Showcase fits situations like: positioning has changed; README screenshots are stale; A launch/demo workspace is needed; the user asks to populate agents.

How do I install Readme Showcase in Claude Code?

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

How do I install Readme Showcase in Codex?

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

Can I use Readme Showcase 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 bagofwords1/bagofwords --skill readme-showcase -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-showcase, .gemini/skills/readme-showcase, .github/skills/readme-showcase and .opencode/skills/readme-showcase in your project.

What does Readme Showcase need to run?

Going by SKILL.md and its folder, Readme Showcase needs the command-line tools its instructions call (git).

Does Readme Showcase access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Readme Showcase safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Readme Showcase use?

Readme Showcase has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Readme Showcase use?

About 1.8k tokens (SKILL.md is roughly 7.4k 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 Showcase?

Skills that share tags, products or a category with Readme Showcase: Get API Docs with chub (andrewyng/context-hub, 14k stars), Adk Sample Creator (google/adk-python, 22k stars), Create Skill (Hyk260/PureChat, 546 stars) and Env And Assets Bootstrap (lllllllama/RigorPilot-Skills, 497 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Readme Showcase?

bagofwords1 (a GitHub organization) maintains it in bagofwords1/bagofwords, which has 459 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 9, 2026.

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