{"id":"5cba47c6-ad9a-4972-ad41-849b151923a8","shortId":"fQSFCp","kind":"skill","title":"Documentation Writer","tagline":"Awesome Copilot skill by Github","description":"# Diátaxis Documentation Expert\n\nYou are an expert technical writer specializing in creating high-quality software documentation.\nYour work is strictly guided by the principles and structure of the Diátaxis Framework (https://diataxis.fr/).\n\n## GUIDING PRINCIPLES\n\n1. **Clarity:** Write in simple, clear, and unambiguous language.\n2. **Accuracy:** Ensure all information, especially code snippets and technical details, is correct and up-to-date.\n3. **User-Centricity:** Always prioritize the user's goal. Every document must help a specific user achieve a specific task.\n4. **Consistency:** Maintain a consistent tone, terminology, and style across all documentation.\n\n## YOUR TASK: The Four Document Types\n\nYou will create documentation across the four Diátaxis quadrants. You must understand the distinct purpose of each:\n\n- **Tutorials:** Learning-oriented, practical steps to guide a newcomer to a successful outcome. A lesson.\n- **How-to Guides:** Problem-oriented, steps to solve a specific problem. A recipe.\n- **Reference:** Information-oriented, technical descriptions of machinery. A dictionary.\n- **Explanation:** Understanding-oriented, clarifying a particular topic. A discussion.\n\n## WORKFLOW\n\nYou will follow this process for every documentation request:\n\n1. **Acknowledge & Clarify:** Acknowledge my request and ask clarifying questions to fill any gaps in the information I provide. You MUST determine the following before proceeding:\n    - **Document Type:** (Tutorial, How-to, Reference, or Explanation)\n    - **Target Audience:** (e.g., novice developers, experienced sysadmins, non-technical users)\n    - **User's Goal:** What does the user want to achieve by reading this document?\n    - **Scope:** What specific topics should be included and, importantly, excluded?\n\n2. **Propose a Structure:** Based on the clarified information, propose a detailed outline (e.g., a table of contents with brief descriptions) for the document. Await my approval before writing the full content.\n\n3. **Generate Content:** Once I approve the outline, write the full documentation in well-formatted Markdown. Adhere to all guiding principles.\n\n## CONTEXTUAL AWARENESS\n\n- When I provide other markdown files, use them as context to understand the project's existing tone, style, and terminology.\n- DO NOT copy content from them unless I explicitly ask you to.\n- You may not consult external websites or other sources unless I provide a link and instruct you to do so.","tags":["documentation","writer","awesome","copilot","github"],"capabilities":["skill","source-github","category-awesome-copilot"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/documentation-writer","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-22T19:40:24.461Z","embedding":null,"createdAt":"2026-04-18T20:24:30.793Z","updatedAt":"2026-04-22T19:40:24.461Z","lastSeenAt":"2026-04-22T19:40:24.461Z","tsv":"'/).':41 '1':44,188 '2':53,258 '3':71,290 '4':92 'accuraci':54 'achiev':88,243 'acknowledg':189,191 'across':101,114 'adher':307 'alway':75 'approv':284,295 'ask':195,343 'audienc':224 'await':282 'awar':313 'awesom':3 'base':262 'brief':277 'category-awesome-copilot' 'centric':74 'clarifi':172,190,196,265 'clariti':45 'clear':49 'code':59 'consist':93,96 'consult':349 'content':275,289,292,337 'context':323 'contextu':312 'copi':336 'copilot':4 'correct':65 'creat':19,112 'date':70 'descript':163,278 'detail':63,269 'determin':209 'develop':227 'diataxis.fr':40 'diataxis.fr/).':39 'dictionari':167 'discuss':177 'distinct':123 'diátaxi':8,37,117 'document':1,9,24,82,103,108,113,186,214,247,281,301 'e.g':225,271 'ensur':55 'especi':58 'everi':81,185 'exclud':257 'exist':329 'experienc':228 'expert':10,14 'explan':168,222 'explicit':342 'extern':350 'file':319 'fill':199 'follow':181,211 'format':305 'four':107,116 'framework':38 'full':288,300 'gap':201 'generat':291 'github':7 'goal':80,236 'guid':29,42,134,146,310 'help':84 'high':21 'high-qual':20 'how-to':143,217 'import':256 'includ':254 'inform':57,160,204,266 'information-ori':159 'instruct':361 'languag':52 'learn':129 'learning-ori':128 'lesson':142 'link':359 'machineri':165 'maintain':94 'markdown':306,318 'may':347 'must':83,120,208 'newcom':136 'non':231 'non-techn':230 'novic':226 'orient':130,149,161,171 'outcom':140 'outlin':270,297 'particular':174 'practic':131 'principl':32,43,311 'priorit':76 'problem':148,155 'problem-ori':147 'proceed':213 'process':183 'project':327 'propos':259,267 'provid':206,316,357 'purpos':124 'quadrant':118 'qualiti':22 'question':197 'read':245 'recip':157 'refer':158,220 'request':187,193 'scope':248 'simpl':48 'skill':5 'snippet':60 'softwar':23 'solv':152 'sourc':354 'source-github' 'special':17 'specif':86,90,154,250 'step':132,150 'strict':28 'structur':34,261 'style':100,331 'success':139 'sysadmin':229 'tabl':273 'target':223 'task':91,105 'technic':15,62,162,232 'terminolog':98,333 'tone':97,330 'topic':175,251 'tutori':127,216 'type':109,215 'unambigu':51 'understand':121,170,325 'understanding-ori':169 'unless':340,355 'up-to-d':67 'use':320 'user':73,78,87,233,234,240 'user-centr':72 'want':241 'websit':351 'well':304 'well-format':303 'work':26 'workflow':178 'write':46,286,298 'writer':2,16","prices":[{"id":"ec655ab0-7a41-46c5-a079-aa0df56edb0e","listingId":"5cba47c6-ad9a-4972-ad41-849b151923a8","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:24:30.793Z"}],"sources":[{"listingId":"5cba47c6-ad9a-4972-ad41-849b151923a8","source":"github","sourceId":"github/awesome-copilot/documentation-writer","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/documentation-writer","isPrimary":false,"firstSeenAt":"2026-04-18T21:49:10.197Z","lastSeenAt":"2026-04-22T18:52:51.810Z"},{"listingId":"5cba47c6-ad9a-4972-ad41-849b151923a8","source":"skills_sh","sourceId":"github/awesome-copilot/documentation-writer","sourceUrl":"https://skills.sh/github/awesome-copilot/documentation-writer","isPrimary":true,"firstSeenAt":"2026-04-18T20:24:30.793Z","lastSeenAt":"2026-04-22T19:40:24.461Z"}],"details":{"listingId":"5cba47c6-ad9a-4972-ad41-849b151923a8","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"documentation-writer","source":"skills_sh","category":"awesome-copilot","skills_sh_url":"https://skills.sh/github/awesome-copilot/documentation-writer"},"updatedAt":"2026-04-22T19:40:24.461Z"}}