{"id":"5cba47c6-ad9a-4972-ad41-849b151923a8","shortId":"fQSFCp","kind":"skill","title":"documentation-writer","tagline":"Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework.","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","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-documentation-writer","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/documentation-writer","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 (2,471 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:10.133Z","embedding":null,"createdAt":"2026-04-18T20:24:30.793Z","updatedAt":"2026-05-18T18:52:10.133Z","lastSeenAt":"2026-05-18T18:52:10.133Z","tsv":"'/).':65 '1':68,212 '2':77,282 '3':95,314 '4':116 'accuraci':78 'achiev':112,267 'acknowledg':213,215 'across':125,138 'adher':331 'alway':99 'approv':308,319 'ask':219,367 'audienc':248 'author':30 'await':306 'awar':337 'base':286 'brief':301 'centric':98 'clarifi':196,214,220,289 'clariti':69 'clear':73 'code':83 'consist':117,120 'consult':373 'content':299,313,316,361 'context':347 'contextu':336 'copi':360 'correct':89 'creat':13,43,136 'date':94 'descript':187,302 'detail':87,293 'determin':233 'develop':251 'diataxis.fr':64 'diataxis.fr/).':63 'dictionari':191 'discuss':201 'distinct':147 'diátaxi':4,27,32,61,141 'document':2,5,18,29,33,48,106,127,132,137,210,238,271,305,325 'documentation-writ':1 'e.g':249,295 'ensur':79 'especi':82 'everi':105,209 'exclud':281 'exist':353 'experienc':252 'expert':6,8,34,38 'explan':192,246 'explicit':366 'extern':374 'file':343 'fill':223 'follow':205,235 'format':329 'four':131,140 'framework':31,62 'full':312,324 'gap':225 'generat':315 'goal':104,260 'guid':19,53,66,158,170,334 'help':108 'high':15,45 'high-qual':14,44 'how-to':167,241 'import':280 'includ':278 'inform':81,184,228,290 'information-ori':183 'instruct':385 'languag':76 'learn':153 'learning-ori':152 'lesson':166 'link':383 'machineri':189 'maintain':118 'markdown':330,342 'may':371 'must':107,144,232 'newcom':160 'non':255 'non-techn':254 'novic':250 'orient':154,173,185,195 'outcom':164 'outlin':294,321 'particular':198 'practic':155 'principl':22,56,67,335 'priorit':100 'problem':172,179 'problem-ori':171 'proceed':237 'process':207 'project':351 'propos':283,291 'provid':230,340,381 'purpos':148 'quadrant':142 'qualiti':16,46 'question':221 'read':269 'recip':181 'refer':182,244 'request':211,217 'scope':272 'simpl':72 'skill' 'skill-documentation-writer' 'snippet':84 'softwar':17,47 'solv':176 'sourc':378 'source-github' 'special':11,41 'specif':110,114,178,274 'step':156,174 'strict':52 'structur':24,58,285 'style':124,355 'success':163 'sysadmin':253 'tabl':297 'target':247 'task':115,129 'technic':9,28,39,86,186,256 'terminolog':122,357 'tone':121,354 'topic':199,275 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'tutori':151,240 'type':133,239 'unambigu':75 'understand':145,194,349 'understanding-ori':193 'unless':364,379 'up-to-d':91 'use':344 'user':97,102,111,257,258,264 'user-centr':96 'want':265 'websit':375 'well':328 'well-format':327 'work':50 'workflow':202 'write':70,310,322 'writer':3,10,40","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-05-18T18:52:10.133Z"},{"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-05-07T22:40:14.870Z"}],"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","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":"93e3fbf57fe64179570de382347db8258c661b56","skill_md_path":"skills/documentation-writer/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/documentation-writer"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"documentation-writer","description":"Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/documentation-writer"},"updatedAt":"2026-05-18T18:52:10.133Z"}}