{"id":"b17e5bb5-cfaa-4c5f-98f4-2c80860528b4","shortId":"Mzfcan","kind":"skill","title":"create-tldr-page","tagline":"Create a tldr page from documentation URLs and command examples, requiring both URL and command name.","description":"# Create TLDR Page\n\n## Overview\n\nYou are an expert technical documentation specialist who creates concise, actionable `tldr` pages\nfollowing the tldr-pages project standards. Your task is to transform verbose documentation into\nclear, example-driven command references.\n\n## Objectives\n\n1. **Require both URL and command** - If either is missing, provide helpful guidance to obtain them\n2. **Extract key examples** - Identify the most common and useful command patterns\n3. **Follow tldr format strictly** - Use the template structure with proper markdown formatting\n4. **Validate documentation source** - Ensure the URL points to authoritative upstream documentation\n\n## Prompt Parameters\n\n### Required\n\n* **Command** - The name of the command or tool (e.g., `git`, `nmcli`, `distrobox-create`)\n* **URL** - Link to authoritative upstream documentation\n  - If one or more URLs are passed without a preceding `#fetch`, apply #tool:fetch to the first URL\n  - If ${file} is provided in lieu of a URL, and ${file} has a relevant URL to **command**, then use\n  the data from the file as if fetched from the URL; use the URL extracted from the file when\n  creating the `tldr` page\n    - If more than one URL is in the file, prompt for which URL should be used for the `tldr` page\n\n### Optional\n\n* **Context files** - Additional documentation or examples\n* **Search data** - Results from documentation searches\n* **Text data** - Raw text from manual pages or help output\n* **Help output** - Raw data matching `-h`, `--help`, `/?`, `--tldr`, `--man`, etc.\n\n> [!IMPORTANT]\n> If a help argument (like `--help` or `--tldr`) is passed, provide a summary of THIS prompt,\nrendering the output as markdown using the tldr template format. Do NOT create a new tldr page for\nthe command.\n\n## Usage\n\n### Syntax\n\n```bash\n/create-tldr-page #fetch <URL> <command> [text data] [context file]\n```\n\n### Error Handling\n\n#### Missing Command\n\n**User**\n\n```bash\n/create-tldr-page https://some-command.io/docs/manual.html\n```\n\n**Agent**\n\n```text\nI'll fetch the URL and analyze the documentation.\nFrom the data extracted, I assume the command is `some-command`. Is this correct? (yes/no)\n```\n\n#### Missing URL\n\n**User**\n\n```bash\n/create-tldr-page some-command\n```\n\n**Agent**\n\n```text\nA URL to authoritative documentation is required for tldr pages. Here are some acceptable URL\npatterns:\n\n1. https://gnu.org/software/manual/html_node/some-command.html\n2. https://some.org/serve/some.man.html#some-command\n3. https://some-command.io/docs/cli/latest/manual\n4. https://some-command.io/docs/quickstart\n\nPlease provide the documentation URL for `some-command`.\n```\n\n## Template\n\nUse this template structure when creating tldr pages:\n\n```markdown\n# command\n\n> Short, snappy description.\n> Some subcommands such as `subcommand1` have their own usage documentation.\n> More information: <https://url-to-upstream.tld>.\n\n- View documentation for creating something:\n\n`tldr command-subcommand1`\n\n- View documentation for managing something:\n\n`tldr command-subcommand2`\n```\n\n### Template Guidelines\n\n- **Title**: Use exact command name (lowercase)\n- **Description**: One-line summary of what the command does\n- **Subcommands note**: Only include if relevant\n- **More information**: Link to authoritative upstream documentation (required)\n- **Examples**: 5-8 most common use cases, ordered by frequency of use\n- **Placeholders**: Use `{{placeholder}}` syntax for user-provided values\n\n## Examples\n\n### Reference Examples\n\nYou MAY fetch these example tldr pages to understand the proper format and style:\n\n* [git](https://raw.githubusercontent.com/jhauga/tldr/refs/heads/main/pages/common/git.md)\n* [distrobox-create](https://raw.githubusercontent.com/jhauga/tldr/refs/heads/main/pages/linux/distrobox-create.md)\n* [nmcli](https://raw.githubusercontent.com/jhauga/tldr/refs/heads/main/pages/linux/nmcli.md)\n\n### Expected Output Using Example\n\n**User**\n\n```bash\n/create-tldr-page #fetch https://git-scm.com/docs/git git\n```\n\n**Agent**\n\n````markdown\n# git\n\n> Distributed version control system.\n> Some subcommands such as `commit`, `add`, `branch`, `switch`, `push`, etc. have their own usage documentation.\n> More information: <https://git-scm.com/docs/git>.\n\n- Create an empty Git repository:\n\n`git init`\n\n- Clone a remote Git repository from the internet:\n\n`git clone {{https://example.com/repo.git}}`\n\n- View the status of the local repository:\n\n`git status`\n\n- Stage all changes for a commit:\n\n`git add {{[-A|--all]}}`\n\n- Commit changes to version history:\n\n`git commit {{[-m|--message]}} {{message_text}}`\n\n- Push local commits to a remote repository:\n\n`git push`\n\n- Pull any changes made to a remote:\n\n`git pull`\n\n- Reset everything the way it was in the latest commit:\n\n`git reset --hard; git clean {{[-f|--force]}}`\n````\n\n### Output Formatting Rules\n\nYou MUST follow these placeholder conventions:\n\n- **Options with arguments**: When an option takes an argument, wrap BOTH the option AND its argument separately\n  - Example: `minipro {{[-p|--device]}} {{chip_name}}`\n  - Example: `git commit {{[-m|--message]}} {{message_text}}`\n  - **DO NOT** combine them as: `minipro -p {{chip_name}}` (incorrect)\n\n- **Options without arguments**: Wrap standalone options (flags) that don't take arguments\n  - Example: `minipro {{[-E|--erase]}}`\n  - Example: `git add {{[-A|--all]}}`\n\n- **Single short options**: Do NOT wrap single short options when used alone without long form\n  - Example: `ls -l` (not wrapped)\n  - Example: `minipro -L` (not wrapped)\n  - However, if both short and long forms exist, wrap them: `{{[-l|--list]}}`\n\n- **Subcommands**: Generally do NOT wrap subcommands unless they are user-provided variables\n  - Example: `git init` (not wrapped)\n  - Example: `tldr {{command}}` (wrapped when variable)\n\n- **Arguments and operands**: Always wrap user-provided values\n  - Example: `{{device_name}}`, `{{chip_name}}`, `{{repository_url}}`\n  - Example: `{{path/to/file}}` for file paths\n  - Example: `{{https://example.com}}` for URLs\n\n- **Command structure**: Options should appear BEFORE their arguments in the placeholder syntax\n  - Correct: `command {{[-o|--option]}} {{value}}`\n  - Incorrect: `command -o {{value}}`","tags":["create","tldr","page","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-create-tldr-page","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/create-tldr-page","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (6,181 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:08.817Z","embedding":null,"createdAt":"2026-04-18T20:26:04.252Z","updatedAt":"2026-05-18T18:52:08.817Z","lastSeenAt":"2026-05-18T18:52:08.817Z","tsv":"'-8':462 '/create-tldr-page':289,301,336,518 '/docs/cli/latest/manual':369 '/docs/git':522,550 '/docs/manual.html':304 '/docs/quickstart':373 '/jhauga/tldr/refs/heads/main/pages/common/git.md)':501 '/jhauga/tldr/refs/heads/main/pages/linux/distrobox-create.md)':507 '/jhauga/tldr/refs/heads/main/pages/linux/nmcli.md)':511 '/repo.git':570 '/serve/some.man.html#some-command':365 '/software/manual/html_node/some-command.html':361 '1':60,358 '2':76,362 '3':88,366 '4':101,370 '5':461 'accept':355 'action':35 'add':536,587,703 'addit':219 'agent':305,340,524 'alon':717 'alway':770 'analyz':313 'appear':796 'appli':147 'argument':253,647,653,660,687,696,767,799 'assum':321 'authorit':110,133,345,456 'bash':288,300,335,517 'branch':537 'case':466 'chang':582,591,612 'chip':666,682,779 'clean':633 'clear':53 'clone':558,567 'combin':677 'command':13,19,57,65,86,116,121,170,285,298,323,327,339,382,393,417,426,433,444,763,792,805,810 'command-subcommand1':416 'command-subcommand2':425 'commit':535,585,590,596,603,628,670 'common':83,464 'concis':34 'context':217,293 'control':529 'convent':644 'correct':330,804 'creat':2,5,21,33,129,192,278,389,413,504,551 'create-tldr-pag':1 'data':174,224,230,242,292,318 'descript':396,436 'devic':665,777 'distribut':527 'distrobox':128,503 'distrobox-cr':127,502 'document':10,30,51,103,112,135,220,227,315,346,377,406,411,420,458,545 'driven':56 'e':699 'e.g':124 'either':67 'empti':553 'ensur':105 'eras':700 'error':295 'etc':248,540 'everyth':620 'exact':432 'exampl':14,55,79,222,460,481,483,488,515,662,668,697,701,721,726,756,761,776,783,788 'example-driven':54 'example.com':569,789 'example.com/repo.git':568 'exist':738 'expect':512 'expert':28 'extract':77,187,319 'f':634 'fetch':146,149,180,290,309,486,519 'file':155,164,177,190,204,218,294,786 'first':152 'flag':691 'follow':38,89,641 'forc':635 'form':720,737 'format':91,100,275,495,637 'frequenc':469 'general':744 'git':125,498,523,526,554,556,561,566,578,586,595,608,617,629,632,669,702,757 'git-scm.com':521,549 'git-scm.com/docs/git':520,548 'gnu.org':360 'gnu.org/software/manual/html_node/some-command.html':359 'guidanc':72 'guidelin':429 'h':244 'handl':296 'hard':631 'help':71,237,239,245,252,255 'histori':594 'howev':731 'identifi':80 'import':249 'includ':449 'incorrect':684,809 'inform':408,453,547 'init':557,758 'internet':565 'key':78 'l':723,728,741 'latest':627 'lieu':159 'like':254 'line':439 'link':131,454 'list':742 'll':308 'local':576,602 'long':719,736 'lowercas':435 'ls':722 'm':597,671 'made':613 'man':247 'manag':422 'manual':234 'markdown':99,270,392,525 'match':243 'may':485 'messag':598,599,672,673 'minipro':663,680,698,727 'miss':69,297,332 'must':640 'name':20,118,434,667,683,778,780 'new':280 'nmcli':126,508 'note':447 'o':806,811 'object':59 'obtain':74 'one':137,199,438 'one-lin':437 'operand':769 'option':216,645,650,657,685,690,708,714,794,807 'order':467 'output':238,240,268,513,636 'overview':24 'p':664,681 'page':4,8,23,37,42,195,215,235,282,351,391,490 'paramet':114 'pass':142,259 'path':787 'path/to/file':784 'pattern':87,357 'placehold':472,474,643,802 'pleas':374 'point':108 'preced':145 'project':43 'prompt':113,205,265 'proper':98,494 'provid':70,157,260,375,479,754,774 'pull':610,618 'push':539,601,609 'raw':231,241 'raw.githubusercontent.com':500,506,510 'raw.githubusercontent.com/jhauga/tldr/refs/heads/main/pages/common/git.md)':499 'raw.githubusercontent.com/jhauga/tldr/refs/heads/main/pages/linux/distrobox-create.md)':505 'raw.githubusercontent.com/jhauga/tldr/refs/heads/main/pages/linux/nmcli.md)':509 'refer':58,482 'relev':167,451 'remot':560,606,616 'render':266 'repositori':555,562,577,607,781 'requir':15,61,115,348,459 'reset':619,630 'result':225 'rule':638 'search':223,228 'separ':661 'short':394,707,713,734 'singl':706,712 'skill' 'skill-create-tldr-page' 'snappi':395 'some-command':325,337,380 'some-command.io':303,368,372 'some-command.io/docs/cli/latest/manual':367 'some-command.io/docs/manual.html':302 'some-command.io/docs/quickstart':371 'some.org':364 'some.org/serve/some.man.html#some-command':363 'someth':414,423 'sourc':104 'source-github' 'specialist':31 'stage':580 'standalon':689 'standard':44 'status':573,579 'strict':92 'structur':96,387,793 'style':497 'subcommand':398,446,532,743,748 'subcommand1':401,418 'subcommand2':427 'summari':262,440 'switch':538 'syntax':287,475,803 'system':530 'take':651,695 'task':46 'technic':29 'templat':95,274,383,386,428 'text':229,232,291,306,341,600,674 'titl':430 'tldr':3,7,22,36,41,90,194,214,246,257,273,281,350,390,415,424,489,762 'tldr-page':40 'tool':123,148 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'transform':49 'understand':492 'unless':749 'upstream':111,134,457 'url':11,17,63,107,130,140,153,162,168,183,186,200,208,311,333,343,356,378,782,791 'url-to-upstream.tld':409 'usag':286,405,544 'use':85,93,172,184,211,271,384,431,465,471,473,514,716 'user':299,334,478,516,753,773 'user-provid':477,752,772 'valid':102 'valu':480,775,808,812 'variabl':755,766 'verbos':50 'version':528,593 'view':410,419,571 'way':622 'without':143,686,718 'wrap':654,688,711,725,730,739,747,760,764,771 'yes/no':331","prices":[{"id":"338e98b6-952b-4e16-8a3b-5c3ca42311a2","listingId":"b17e5bb5-cfaa-4c5f-98f4-2c80860528b4","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-04-18T20:26:04.252Z"}],"sources":[{"listingId":"b17e5bb5-cfaa-4c5f-98f4-2c80860528b4","source":"github","sourceId":"github/awesome-copilot/create-tldr-page","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/create-tldr-page","isPrimary":false,"firstSeenAt":"2026-04-18T21:48:56.106Z","lastSeenAt":"2026-05-18T18:52:08.817Z"},{"listingId":"b17e5bb5-cfaa-4c5f-98f4-2c80860528b4","source":"skills_sh","sourceId":"github/awesome-copilot/create-tldr-page","sourceUrl":"https://skills.sh/github/awesome-copilot/create-tldr-page","isPrimary":true,"firstSeenAt":"2026-04-18T20:26:04.252Z","lastSeenAt":"2026-05-07T22:40:18.671Z"}],"details":{"listingId":"b17e5bb5-cfaa-4c5f-98f4-2c80860528b4","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"create-tldr-page","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"f9542ddc00f2132ef389d07f5287dfb01967c8dd","skill_md_path":"skills/create-tldr-page/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/create-tldr-page"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"create-tldr-page","description":"Create a tldr page from documentation URLs and command examples, requiring both URL and command name."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/create-tldr-page"},"updatedAt":"2026-05-18T18:52:08.817Z"}}