{"id":"4e744ed9-94e8-4091-8bf4-536b2ba0fa29","shortId":"cgpkDM","kind":"skill","title":"Gen Specs As Issues","tagline":"Awesome Copilot skill by Github","description":"# Product Manager Assistant: Feature Identification and Specification\n\nThis workflow guides you through a systematic approach to identify missing features, prioritize them, and create detailed specifications for implementation.\n\n## 1. Project Understanding Phase\n\n- Review the project structure to understand its organization\n- Read the README.md and other documentation files to understand the project's core functionality\n- Identify the existing implementation status by examining:\n  - Main entry points (CLI, API, UI, etc.)\n  - Core modules and their functionality\n  - Tests to understand expected behavior\n  - Any placeholder implementations\n\n**Guiding Questions:**\n- What is the primary purpose of this project?\n- What user problems does it solve?\n- What patterns exist in the current implementation?\n- Which features are mentioned in documentation but not fully implemented?\n\n## 2. Gap Analysis Phase\n\n- Compare the documented capabilities ONLY against the actual implementation\n- Identify \"placeholder\" code that lacks real functionality\n- Look for features mentioned in documentation but missing robust implementation\n- Consider the user journey and identify broken or missing steps\n- Focus on core functionality first (not nice-to-have features)\n\n**Output Creation:**\n- Create a list of potential missing features (5-7 items)\n- For each feature, note:\n  - Current implementation status\n  - References in documentation\n  - Impact on user experience if missing\n\n## 3. Prioritization Phase\n\n- Apply a score to each identified gap:\n\n**Scoring Matrix (1-5 scale):**\n- User Impact: How many users benefit?\n- Strategic Alignment: Fits core mission?\n- Implementation Feasibility: Technical complexity?\n- Resource Requirements: Development effort needed?\n- Risk Level: Potential negative impacts?\n\n**Priority = (User Impact × Strategic Alignment) / (Implementation Effort × Risk Level)**\n\n**Output Creation:**\n- Present the top 3 highest-priority missing features based on the scoring\n- For each, provide:\n  - Feature name\n  - Current status\n  - Impact if not implemented\n  - Dependencies on other features\n\n## 4. Specification Development Phase\n\n- For each prioritized feature, develop a detailed but practical specification:\n  - Begin with the philosophical approach: simplicity over complexity\n  - Focus on MVP functionality first\n  - Consider the developer experience\n  - Keep the specification implementation-friendly\n\n**For Each Feature Specification:**\n1. **Overview & Scope**\n   - What problem does it solve?\n   - What's included and what's explicitly excluded?\n\n2. **Technical Requirements**\n   - Core functionality needed\n   - User-facing interfaces (API, UI, CLI, etc.)\n   - Integration points with existing code\n\n3. **Implementation Plan**\n   - Key modules/files to create or modify\n   - Simple code examples showing the approach\n   - Clear data structures and interfaces\n\n4. **Acceptance Criteria**\n   - How will we know when it's done?\n   - What specific functionality must work?\n   - What tests should pass?\n\n## 5. GitHub Issue Creation Phase\n\n- For each specification, create a GitHub issue:\n  - Clear, descriptive title\n  - Comprehensive specification in the body\n  - Appropriate labels (enhancement, high-priority, etc.)\n  - Explicitly mention MVP philosophy where relevant\n\n**Issue Template Structure:**\n\n# [Feature Name]\n\n## Overview\n[Brief description of the feature and its purpose]\n\n## Scope\n[What's included and what's explicitly excluded]\n\n## Technical Requirements\n[Specific technical needs and constraints]\n\n## Implementation Plan\n[Step-by-step approach with simple code examples]\n\n## Acceptance Criteria\n[Clear list of requirements to consider the feature complete]\n\n## Priority\n[Justification for prioritization]\n\n## Dependencies\n- **Blocks:** [List of issues blocked by this one]\n- **Blocked by:** [List of issues this one depends on]\n\n## Implementation Size\n- **Estimated effort:** [Small/Medium/Large]\n- **Sub-issues:** [Links to sub-issues if this is a parent issue]\n\n\n## 5.5 Work Distribution Optimization\n\n- **Independence Analysis**\n  - Review each specification to identify truly independent components\n  - Refactor specifications to maximize independent work streams\n  - Create clear boundaries between interdependent components\n\n- **Dependency Mapping**\n  - For features with unavoidable dependencies, establish clear issue hierarchies\n  - Create parent issues for the overall feature with sub-issues for components\n  - Explicitly document \"blocked by\" and \"blocks\" relationships\n\n- **Workload Balancing**\n  - Break down large specifications into smaller, manageable sub-issues\n  - Ensure each sub-issue represents 1-3 days of development work\n  - Include sub-issue specific acceptance criteria\n\n**Implementation Guidelines:**\n- Use GitHub issue linking syntax to create explicit relationships\n- Add labels to indicate dependency status (e.g., \"blocked\", \"prerequisite\")\n- Include estimated complexity/effort for each issue to aid sprint planning\n\n## 6. Final Review Phase\n\n- Summarize all created specifications\n- Highlight implementation dependencies between features\n- Suggest a logical implementation order\n- Note any potential challenges or considerations\n\nRemember throughout this process:\n- Favor simplicity over complexity\n- Start with minimal viable implementations that work\n- Focus on developer experience\n- Build a foundation that can be extended later\n- Consider the open-source community and contribution model\n\nThis workflow embodiment of our approach should help maintain consistency in how features are specified and prioritized, ensuring that software projects evolve in a thoughtful, user-centered way.","tags":["gen","specs","issues","awesome","copilot","github"],"capabilities":["skill","source-github","category-awesome-copilot"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/gen-specs-as-issues","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-22T09:40:13.784Z","embedding":null,"createdAt":"2026-04-18T20:26:07.839Z","updatedAt":"2026-04-22T09:40:13.784Z","lastSeenAt":"2026-04-22T09:40:13.784Z","tsv":"'-3':600 '-5':215 '-7':184 '1':37,214,322,599 '2':123,338 '3':202,256,357 '4':281,377 '5':183,397 '5.5':523 '6':642 'accept':378,471,610 'actual':134 'add':623 'aid':639 'align':224,246 'analysi':125,528 'api':74,348 'appli':205 'approach':24,299,371,466,707 'appropri':417 'assist':12 'awesom':5 'balanc':582 'base':262 'begin':295 'behavior':86 'benefit':222 'block':487,491,495,576,579,630 'bodi':416 'boundari':546 'break':583 'brief':436 'broken':159 'build':685 'capabl':130 'category-awesome-copilot' 'center':729 'challeng':663 'clear':372,409,473,545,558 'cli':73,350 'code':138,356,367,469 'communiti':698 'compar':127 'complet':481 'complex':231,302,673 'complexity/effort':634 'compon':536,549,573 'comprehens':412 'consid':153,308,478,693 'consider':665 'consist':711 'constraint':459 'contribut':700 'copilot':6 'core':61,77,165,226,341 'creat':32,176,363,405,544,561,620,648 'creation':175,252,400 'criteria':379,472,611 'current':111,190,271 'data':373 'day':601 'depend':277,486,502,550,556,627,652 'descript':410,437 'detail':33,291 'develop':234,283,289,310,603,683 'distribut':525 'document':54,118,129,148,195,575 'done':387 'e.g':629 'effort':235,248,507 'embodi':704 'enhanc':419 'ensur':593,719 'entri':71 'establish':557 'estim':506,633 'etc':76,351,423 'evolv':723 'examin':69 'exampl':368,470 'exclud':337,452 'exist':65,108,355 'expect':85 'experi':199,311,684 'explicit':336,424,451,574,621 'extend':691 'face':346 'favor':670 'feasibl':229 'featur':13,28,114,145,173,182,188,261,269,280,288,320,433,440,480,553,567,654,714 'file':55 'final':643 'first':167,307 'fit':225 'focus':163,303,681 'foundat':687 'friend':317 'fulli':121 'function':62,81,142,166,306,342,390 'gap':124,211 'gen':1 'github':9,398,407,615 'guid':19,90 'guidelin':613 'help':709 'hierarchi':560 'high':421 'high-prior':420 'highest':258 'highest-prior':257 'highlight':650 'identif':14 'identifi':26,63,136,158,210,533 'impact':196,218,241,244,273 'implement':36,66,89,112,122,135,152,191,228,247,276,316,358,460,504,612,651,658,678 'implementation-friend':315 'includ':332,447,605,632 'independ':527,535,541 'indic':626 'integr':352 'interdepend':548 'interfac':347,376 'issu':4,399,408,430,490,499,511,516,522,559,563,571,592,597,608,616,637 'item':185 'journey':156 'justif':483 'keep':312 'key':360 'know':383 'label':418,624 'lack':140 'larg':585 'later':692 'level':238,250 'link':512,617 'list':178,474,488,497 'logic':657 'look':143 'main':70 'maintain':710 'manag':11,589 'mani':220 'map':551 'matrix':213 'maxim':540 'mention':116,146,425 'minim':676 'miss':27,150,161,181,201,260 'mission':227 'model':701 'modifi':365 'modul':78 'modules/files':361 'must':391 'mvp':305,426 'name':270,434 'need':236,343,457 'negat':240 'nice':170 'nice-to-hav':169 'note':189,660 'one':494,501 'open':696 'open-sourc':695 'optim':526 'order':659 'organ':48 'output':174,251 'overal':566 'overview':323,435 'parent':521,562 'pass':396 'pattern':107 'phase':40,126,204,284,401,645 'philosoph':298 'philosophi':427 'placehold':88,137 'plan':359,461,641 'point':72,353 'potenti':180,239,662 'practic':293 'prerequisit':631 'present':253 'primari':95 'priorit':29,203,287,485,718 'prioriti':242,259,422,482 'problem':102,326 'process':669 'product':10 'project':38,43,59,99,722 'provid':268 'purpos':96,443 'question':91 'read':49 'readme.md':51 'real':141 'refactor':537 'refer':193 'relationship':580,622 'relev':429 'rememb':666 'repres':598 'requir':233,340,454,476 'resourc':232 'review':41,529,644 'risk':237,249 'robust':151 'scale':216 'scope':324,444 'score':207,212,265 'show':369 'simpl':366,468 'simplic':300,671 'size':505 'skill':7 'small/medium/large':508 'smaller':588 'softwar':721 'solv':105,329 'sourc':697 'source-github' 'spec':2 'specif':16,34,282,294,314,321,389,404,413,455,531,538,586,609,649 'specifi':716 'sprint':640 'start':674 'status':67,192,272,628 'step':162,463,465 'step-by-step':462 'strateg':223,245 'stream':543 'structur':44,374,432 'sub':510,515,570,591,596,607 'sub-issu':509,514,569,590,595,606 'suggest':655 'summar':646 'syntax':618 'systemat':23 'technic':230,339,453,456 'templat':431 'test':82,394 'thought':726 'throughout':667 'titl':411 'top':255 'truli':534 'ui':75,349 'unavoid':555 'understand':39,46,57,84 'use':614 'user':101,155,198,217,221,243,345,728 'user-cent':727 'user-fac':344 'viabl':677 'way':730 'work':392,524,542,604,680 'workflow':18,703 'workload':581","prices":[{"id":"6b68072f-3b40-494d-ad83-e357b0262dea","listingId":"4e744ed9-94e8-4091-8bf4-536b2ba0fa29","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:07.839Z"}],"sources":[{"listingId":"4e744ed9-94e8-4091-8bf4-536b2ba0fa29","source":"github","sourceId":"github/awesome-copilot/gen-specs-as-issues","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/gen-specs-as-issues","isPrimary":false,"firstSeenAt":"2026-04-18T21:49:30.882Z","lastSeenAt":"2026-04-22T06:52:21.995Z"},{"listingId":"4e744ed9-94e8-4091-8bf4-536b2ba0fa29","source":"skills_sh","sourceId":"github/awesome-copilot/gen-specs-as-issues","sourceUrl":"https://skills.sh/github/awesome-copilot/gen-specs-as-issues","isPrimary":true,"firstSeenAt":"2026-04-18T20:26:07.839Z","lastSeenAt":"2026-04-22T09:40:13.784Z"}],"details":{"listingId":"4e744ed9-94e8-4091-8bf4-536b2ba0fa29","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"gen-specs-as-issues","source":"skills_sh","category":"awesome-copilot","skills_sh_url":"https://skills.sh/github/awesome-copilot/gen-specs-as-issues"},"updatedAt":"2026-04-22T09:40:13.784Z"}}