<p align="center">
  <img
    src=".github/logo.png"
    align="center"
    width="100"
    alt="llms.txt Generator"
    title="llms.txt Generator"
  />
  <h1 align="center">llms.txt Generator</h1>
</p>

<p align="center">
  Generate /llms.txt files for any project following the <a href="https://llmstxt.org">llmstxt.org</a> specification.
</p>

<p align="center">
  <a href="https://llmstxt.org">
    <img src="https://img.shields.io/static/v1?label=Standard&message=llmstxt.org&color=000000&style=flat" />
  </a>
  <a href="https://skills.sh">
    <img src="https://img.shields.io/static/v1?label=Platform&message=skills.sh&color=7C3AED&style=flat" />
  </a>
  <a href="https://code.claude.com">
    <img src="https://img.shields.io/static/v1?label=Works%20with&message=Claude%20Code&color=D97706&style=flat" />
  </a>
</p>

---

## 📄 What is llms.txt?

The `/llms.txt` file is a proposed standard by Jeremy Howard to help LLMs understand and use websites/projects efficiently. Think of it as `robots.txt` but for AI assistants.

Instead of crawling entire sites, LLMs can read a single markdown file that provides:
- Project overview and context
- Links to key documentation
- Organized resources by category
- Guidance on what's important vs optional

## 📦 Installation

```bash
npx skills add marcelo-earth/llms-txt-generator
```

## 🚀 Usage

Once installed, you can invoke the skill in Claude Code:

```
/llms-txt
```

Or mention the llms-txt skill in your prompt:
- "Use llms-txt to document this project"
- "Generate an llms.txt for this repo"
- "Create LLM-friendly documentation with llms-txt"

## ⚡ What the Skill Does

1. **Analyzes your project** - Scans for README, docs, examples, API references
2. **Identifies key resources** - Finds what's important for understanding the project
3. **Generates llms.txt** - Creates a properly formatted file following the spec

## 📝 Example Output

```markdown
# My Project

> A brief description of what this project does and why it exists.

Important notes:
- Key caveat or compatibility information
- Another critical detail

## Docs

- [Getting Started](docs/getting-started.md): Installation and basic usage
- [API Reference](docs/api.md): Complete function reference

## Examples

- [Basic Usage](examples/basic.py): Simple example to get started

## Optional

- [Advanced Config](docs/advanced.md): For power users
```

## 🤔 Why No Scripts?

This skill doesn't include executable scripts because:

- **The work is intelligent, not mechanical** - Deciding what to include requires understanding the project
- **Claude already has the tools** - Glob, Grep, Read are sufficient for analysis
- **The output is simple** - Just markdown with a specific structure

The value is in the *judgment* of what to include, not in processing files.

## 🤲 Contributing

This is an open source project. If you want to improve the skill, fix a bug, or add new features:

1. Fork the repository
2. Make your changes
3. Submit a pull request

## 📚 Resources

- [llmstxt.org](https://llmstxt.org) - The official specification
- [skills.sh](https://skills.sh) - Skills marketplace
- [Claude Code Docs](https://code.claude.com/docs/en/skills) - How skills work
