{"id":"b17e5bb5-cfaa-4c5f-98f4-2c80860528b4","shortId":"Mzfcan","kind":"skill","title":"Create Tldr Page","tagline":"Awesome Copilot skill by Github","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"],"capabilities":["skill","source-github","category-awesome-copilot"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/create-tldr-page","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under github/awesome-copilot","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:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T11:40:19.787Z","embedding":null,"createdAt":"2026-04-18T20:26:04.252Z","updatedAt":"2026-04-22T11:40:19.787Z","lastSeenAt":"2026-04-22T11:40:19.787Z","tsv":"'-8':450 '/create-tldr-page':277,289,324,506 '/docs/cli/latest/manual':357 '/docs/git':510,538 '/docs/manual.html':292 '/docs/quickstart':361 '/jhauga/tldr/refs/heads/main/pages/common/git.md)':489 '/jhauga/tldr/refs/heads/main/pages/linux/distrobox-create.md)':495 '/jhauga/tldr/refs/heads/main/pages/linux/nmcli.md)':499 '/repo.git':558 '/serve/some.man.html#some-command':353 '/software/manual/html_node/some-command.html':349 '1':48,346 '2':64,350 '3':76,354 '4':89,358 '5':449 'accept':343 'action':23 'add':524,575,691 'addit':207 'agent':293,328,512 'alon':705 'alway':758 'analyz':301 'appear':784 'appli':135 'argument':241,635,641,648,675,684,755,787 'assum':309 'authorit':98,121,333,444 'awesom':4 'bash':276,288,323,505 'branch':525 'case':454 'category-awesome-copilot' 'chang':570,579,600 'chip':654,670,767 'clean':621 'clear':41 'clone':546,555 'combin':665 'command':45,53,74,104,109,158,273,286,311,315,327,370,381,405,414,421,432,751,780,793,798 'command-subcommand1':404 'command-subcommand2':413 'commit':523,573,578,584,591,616,658 'common':71,452 'concis':22 'context':205,281 'control':517 'convent':632 'copilot':5 'correct':318,792 'creat':1,9,21,117,180,266,377,401,492,539 'data':162,212,218,230,280,306 'descript':384,424 'devic':653,765 'distribut':515 'distrobox':116,491 'distrobox-cr':115,490 'document':18,39,91,100,123,208,215,303,334,365,394,399,408,446,533 'driven':44 'e':687 'e.g':112 'either':55 'empti':541 'ensur':93 'eras':688 'error':283 'etc':236,528 'everyth':608 'exact':420 'exampl':43,67,210,448,469,471,476,503,650,656,685,689,709,714,744,749,764,771,776 'example-driven':42 'example.com':557,777 'example.com/repo.git':556 'exist':726 'expect':500 'expert':16 'extract':65,175,307 'f':622 'fetch':134,137,168,278,297,474,507 'file':143,152,165,178,192,206,282,774 'first':140 'flag':679 'follow':26,77,629 'forc':623 'form':708,725 'format':79,88,263,483,625 'frequenc':457 'general':732 'git':113,486,511,514,542,544,549,554,566,574,583,596,605,617,620,657,690,745 'git-scm.com':509,537 'git-scm.com/docs/git':508,536 'github':8 'gnu.org':348 'gnu.org/software/manual/html_node/some-command.html':347 'guidanc':60 'guidelin':417 'h':232 'handl':284 'hard':619 'help':59,225,227,233,240,243 'histori':582 'howev':719 'identifi':68 'import':237 'includ':437 'incorrect':672,797 'inform':396,441,535 'init':545,746 'internet':553 'key':66 'l':711,716,729 'latest':615 'lieu':147 'like':242 'line':427 'link':119,442 'list':730 'll':296 'local':564,590 'long':707,724 'lowercas':423 'ls':710 'm':585,659 'made':601 'man':235 'manag':410 'manual':222 'markdown':87,258,380,513 'match':231 'may':473 'messag':586,587,660,661 'minipro':651,668,686,715 'miss':57,285,320 'must':628 'name':106,422,655,671,766,768 'new':268 'nmcli':114,496 'note':435 'o':794,799 'object':47 'obtain':62 'one':125,187,426 'one-lin':425 'operand':757 'option':204,633,638,645,673,678,696,702,782,795 'order':455 'output':226,228,256,501,624 'overview':12 'p':652,669 'page':3,11,25,30,183,203,223,270,339,379,478 'paramet':102 'pass':130,247 'path':775 'path/to/file':772 'pattern':75,345 'placehold':460,462,631,790 'pleas':362 'point':96 'preced':133 'project':31 'prompt':101,193,253 'proper':86,482 'provid':58,145,248,363,467,742,762 'pull':598,606 'push':527,589,597 'raw':219,229 'raw.githubusercontent.com':488,494,498 'raw.githubusercontent.com/jhauga/tldr/refs/heads/main/pages/common/git.md)':487 'raw.githubusercontent.com/jhauga/tldr/refs/heads/main/pages/linux/distrobox-create.md)':493 'raw.githubusercontent.com/jhauga/tldr/refs/heads/main/pages/linux/nmcli.md)':497 'refer':46,470 'relev':155,439 'remot':548,594,604 'render':254 'repositori':543,550,565,595,769 'requir':49,103,336,447 'reset':607,618 'result':213 'rule':626 'search':211,216 'separ':649 'short':382,695,701,722 'singl':694,700 'skill':6 'snappi':383 'some-command':313,325,368 'some-command.io':291,356,360 'some-command.io/docs/cli/latest/manual':355 'some-command.io/docs/manual.html':290 'some-command.io/docs/quickstart':359 'some.org':352 'some.org/serve/some.man.html#some-command':351 'someth':402,411 'sourc':92 'source-github' 'specialist':19 'stage':568 'standalon':677 'standard':32 'status':561,567 'strict':80 'structur':84,375,781 'style':485 'subcommand':386,434,520,731,736 'subcommand1':389,406 'subcommand2':415 'summari':250,428 'switch':526 'syntax':275,463,791 'system':518 'take':639,683 'task':34 'technic':17 'templat':83,262,371,374,416 'text':217,220,279,294,329,588,662 'titl':418 'tldr':2,10,24,29,78,182,202,234,245,261,269,338,378,403,412,477,750 'tldr-page':28 'tool':111,136 'transform':37 'understand':480 'unless':737 'upstream':99,122,445 'url':51,95,118,128,141,150,156,171,174,188,196,299,321,331,344,366,770,779 'url-to-upstream.tld':397 'usag':274,393,532 'use':73,81,160,172,199,259,372,419,453,459,461,502,704 'user':287,322,466,504,741,761 'user-provid':465,740,760 'valid':90 'valu':468,763,796,800 'variabl':743,754 'verbos':38 'version':516,581 'view':398,407,559 'way':610 'without':131,674,706 'wrap':642,676,699,713,718,727,735,748,752,759 'yes/no':319","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-04-22T06:52:18.535Z"},{"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-04-22T11:40:19.787Z"}],"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","source":"skills_sh","category":"awesome-copilot","skills_sh_url":"https://skills.sh/github/awesome-copilot/create-tldr-page"},"updatedAt":"2026-04-22T11:40:19.787Z"}}