Skip to content

Guide · Agent skill

How to use the Create TLDR Page agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The create-tldr-page skill is an agent skill that writes short, example-driven command reference pages in the tldr format used by the tldr-pages project. You give the agent a documentation URL and a command name, and it distills the most common usages into a one-line description and a list of examples linked back to the official source. This guide is for readers who have never used agent skills and want to install it, trigger it and check its output.

Create TLDR Pagegithub/awesome-copilot · MIT

Quick start

  1. 1Download the skill. Download the ZIP file for create-tldr-page from this page.
  2. 2Unzip it into a skills folder. Unzip the folder into ~/.claude/skills/ for personal use, or into .claude/skills/ inside a project.
  3. 3Or upload it in the Claude apps. Go to Settings → Capabilities → Skills and upload the skill there.
  4. 4Gather a URL and command name. Find the official documentation URL for the tool and note the exact command name.
  5. 5Ask for a tldr page. Use the slash command with the fetch instruction, the URL and the command name.
  6. 6Review the result. Check each example and the More information link against the upstream documentation before using it.

What an agent skill is and what this one does

An agent skill is a folder containing a SKILL.md file of instructions that an AI agent loads when a task matches. This skill is defined by a single SKILL.md file. When it is active, the agent writes a tldr page: a short Markdown page with a title, a one-line description, a link to upstream documentation, and a list of common usages, each with a command example.

The skill is built around two required inputs. It needs a documentation URL and a command name. If either is missing, the skill asks for it rather than guessing. If you pass help output such as the result of --help instead of a URL, the skill summarizes that output in tldr format and does not create a new page.

Install the create-tldr-page skill

You can install the skill in one of three places. Download the ZIP file from this page and unzip it into your personal skills folder at ~/.claude/skills/, or into a project's .claude/skills/ folder if you want it available only in that project. You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.

After unzipping, the skill folder should contain SKILL.md. The source provides no other files for this skill.

  • Personal install: ~/.claude/skills/
  • Project install: .claude/skills/ inside your project
  • Claude apps: Settings → Capabilities → Skills, then upload the skill

Trigger the skill with a natural request

The skill's documented syntax uses a slash command with a fetch instruction, followed by the URL and command name. The skill also accepts optional text data (such as pasted manual text) and context files.

Be explicit about both the URL and the command. If you leave out the command, the agent will try to infer it from the fetched documentation and ask you to confirm with yes or no. If you leave out the URL, the agent will not proceed and will list example URL patterns to find one.

  • Give the URL to the official documentation for the tool.
  • Give the exact command name, for example git or distrobox-create.
  • Optionally paste help output or manual text as extra context.
/create-tldr-page #fetch <URL> <command> [text data] [context file]

Examples of what the skill produces

For the git command, the documented example passes the git documentation URL and the command name git. The skill fetches the page and returns a tldr page starting with the title git, a short description, a note on subcommands, and a More information link to the official docs. The examples follow the form of short usage lines, such as creating a repository, cloning, checking status and committing.

Placeholders in the output use double braces. Options that take a value wrap both the option and its value, and options with a short and long form are written together, for example {{[-m|--message]}}.

/create-tldr-page #fetch https://git-scm.com/docs/git git

Check the output before you publish it

The skill asks the agent to validate that the URL points to authoritative upstream documentation, but the skill file provides no tooling to check this. Treat the URL and every example as something you need to verify yourself against the source.

A tldr page is a summary. It keeps the most common usages and can omit details, so it is not a substitute for a full manual. Compare each example against the documentation before you contribute or rely on it.

  • Confirm the URL is the official documentation for the tool.
  • Run or read each example against the upstream source.
  • Remember that the page covers common usage only.

What people use it for

  • Developers contributing a new tldr page for a command-line tool.
  • Maintainers of internal CLI tools who need a quick usage cheat sheet for their team.
  • Students learning a new command-line tool who want a condensed reference.
  • Turning a tool's help output into a tldr-style summary without creating a new page.

Frequently asked questions

Is the create-tldr-page skill free to use?

The source states the skill is released under the MIT licence. It does not list prices, so check the directory page for any other terms.

What does create-tldr-page require to run?

The source lists no requirements. It does not run scripts, but it does use the network, because the agent fetches the documentation URL you provide.

How do I install an agent skill like this one?

Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use or a project's .claude/skills/ folder. You can also upload it in the Claude apps under Settings → Capabilities → Skills.

Why does the skill ask me for a URL and a command?

The skill requires both. It needs a command name to title the page and a documentation URL to read and to link back to in the More information line. Without both, it asks you for what is missing.

What happens if I pass --help output instead of a URL?

The skill summarizes the help output in tldr format and does not create a new tldr page for the command.

Can I trust that the documentation URL is correct?

Not automatically. The skill asks the agent to validate sources, but the skill file gives no tooling for that, so you should confirm the URL is the official documentation yourself.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use this skill if you are contributing a tldr page, maintaining an internal CLI, or learning a new command and want a short cheat sheet built from official docs. Pick a full manual or the tool's own documentation if you need complete, authoritative detail, since this output is a summary that you must verify.

Download the skill