# Github Readme Generator

> |

- **Type:** Skill
- **Install:** `agentstack add skill-ublaze-github-readme-generator-github-readme-generator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Ublaze](https://agentstack.voostack.com/s/ublaze)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Ublaze](https://github.com/Ublaze)
- **Source:** https://github.com/Ublaze/github-readme-generator

## Install

```sh
agentstack add skill-ublaze-github-readme-generator-github-readme-generator
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# GitHub README Generator

Generate a polished, shareable GitHub README for a project following proven structures that maximize engagement and clarity.

## Arguments
- `$ARGUMENTS` — Project directory path or GitHub repo name

## Instructions

You are helping create a high-quality GitHub README that is both informative and shareable on social media.

### Step 1: Understand the Project

If a directory path is given, explore the codebase:
- Read existing README if any
- Identify the main language, framework, and dependencies (check package.json, requirements.txt, Cargo.toml, go.mod, etc.)
- Understand what the project does, how to install/run it, and key features
- Look for existing assets (screenshots, banners, icons)

If a GitHub repo name is given:
- Detect the user's GitHub account via `gh api user` if only a repo name is provided
- Fetch the repo metadata and README via `gh api`

### Step 2: Generate the README

Use this structure. Adapt sections as appropriate for the project size — a small script needs fewer sections than a full application.

```markdown

  

  [One-line tagline — what it does in plain English]

  [Badges: platform, language version, license, download/install link]

---

**[Project Name]** is a [type of tool] that [what it does]. [One sentence on what makes it different].

[Optional: built with X. No admin rights / no dependencies / single file / etc.]

  

## Why [Project Name]?

[Problem-solution comparison table OR 2-3 paragraphs explaining the motivation]

| Problem | How others solve it | How [Project Name] solves it |
|---------|--------------------|-----------------------------|
| ... | ... | ... |

## Features

- **Feature 1** — brief description
- **Feature 2** — brief description
- **Feature 3** — brief description

## Quick Start

### Option 1: [Easiest method — download/install]

1. Step one
2. Step two
3. Done

### Option 2: [From source / package manager]

\`\`\`bash
commands here
\`\`\`

## How It Works

[Brief architecture explanation — ASCII diagram, flowchart, or text description]

## Configuration

[If applicable — flags, config files, environment variables]

## Comparison

[If applicable — feature comparison table against alternatives]

| Feature | This tool | Alternative A | Alternative B |
|---------|:---------:|:-------------:|:-------------:|
| ... | ... | ... | ... |

## System Requirements

[Platform, runtime, dependencies]

## Building from Source

[If applicable — build commands, test commands]

## Contributing

Contributions welcome! Please open an issue first to discuss what you'd like to change.

## License

[License type] — see [LICENSE](LICENSE) for details.
```

### Step 3: Adapt to Project Size

- **Small script/utility** (under 200 lines): Skip "How It Works", "Configuration", "Comparison", "Building from Source". Keep it concise.
- **Medium project**: Include most sections but keep them brief.
- **Full application**: Use all sections. Add architecture diagrams and detailed configuration docs.

### Step 4: Provide Additional Recommendations

After generating the README, suggest:

- **Social preview image** concept (1280x640) for GitHub repo Settings > Social preview
- **Badge URLs** appropriate for the project (shields.io format)
- **Missing assets** the user should create (banner image, screenshots, demo GIF)
- **GitHub Release** — suggest creating one if none exists
- **Topics** — suggest GitHub repo topics for discoverability

### Rules
- Match the tone to the project's complexity
- Use tables for comparisons, bullet points for features, code blocks for commands
- Keep Quick Start to 3 steps or fewer for the easiest path
- Write in second person ("you") for instructions
- Do NOT add emojis to the README unless the user asks — keep it clean and professional
- Present the generated README in a code block so the user can copy it directly
- If an existing README exists, note what's already good and only suggest additions

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Ublaze](https://github.com/Ublaze)
- **Source:** [Ublaze/github-readme-generator](https://github.com/Ublaze/github-readme-generator)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ublaze-github-readme-generator-github-readme-generator
- Seller: https://agentstack.voostack.com/s/ublaze
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.