{"id":"4e744ed9-94e8-4091-8bf4-536b2ba0fa29","shortId":"cgpkDM","kind":"skill","title":"gen-specs-as-issues","tagline":"This workflow guides you through a systematic approach to identify missing features, prioritize them, and create detailed specifications for implementation.","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","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-gen-specs-as-issues","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/gen-specs-as-issues","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 (5,660 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:12.616Z","embedding":null,"createdAt":"2026-04-18T20:26:07.839Z","updatedAt":"2026-05-18T18:52:12.616Z","lastSeenAt":"2026-05-18T18:52:12.616Z","tsv":"'-3':616 '-5':231 '-7':200 '1':53,230,338,615 '2':139,354 '3':218,272,373 '4':297,393 '5':199,413 '5.5':539 '6':658 'accept':394,487,626 'actual':150 'add':639 'aid':655 'align':240,262 'analysi':141,544 'api':90,364 'appli':221 'approach':13,40,315,387,482,723 'appropri':433 'assist':28 'balanc':598 'base':278 'begin':311 'behavior':102 'benefit':238 'block':503,507,511,592,595,646 'bodi':432 'boundari':562 'break':599 'brief':452 'broken':175 'build':701 'capabl':146 'center':745 'challeng':679 'clear':388,425,489,561,574 'cli':89,366 'code':154,372,383,485 'communiti':714 'compar':143 'complet':497 'complex':247,318,689 'complexity/effort':650 'compon':552,565,589 'comprehens':428 'consid':169,324,494,709 'consider':681 'consist':727 'constraint':475 'contribut':716 'core':77,93,181,242,357 'creat':21,48,192,379,421,560,577,636,664 'creation':191,268,416 'criteria':395,488,627 'current':127,206,287 'data':389 'day':617 'depend':293,502,518,566,572,643,668 'descript':426,453 'detail':22,49,307 'develop':250,299,305,326,619,699 'distribut':541 'document':70,134,145,164,211,591 'done':403 'e.g':645 'effort':251,264,523 'embodi':720 'enhanc':435 'ensur':609,735 'entri':87 'establish':573 'estim':522,649 'etc':92,367,439 'evolv':739 'examin':85 'exampl':384,486 'exclud':353,468 'exist':81,124,371 'expect':101 'experi':215,327,700 'explicit':352,440,467,590,637 'extend':707 'face':362 'favor':686 'feasibl':245 'featur':17,29,44,130,161,189,198,204,277,285,296,304,336,449,456,496,569,583,670,730 'file':71 'final':659 'first':183,323 'fit':241 'focus':179,319,697 'foundat':703 'friend':333 'fulli':137 'function':78,97,158,182,322,358,406 'gap':140,227 'gen':2 'gen-specs-as-issu':1 'github':414,423,631 'guid':8,35,106 'guidelin':629 'help':725 'hierarchi':576 'high':437 'high-prior':436 'highest':274 'highest-prior':273 'highlight':666 'identif':30 'identifi':15,42,79,152,174,226,549 'impact':212,234,257,260,289 'implement':25,52,82,105,128,138,151,168,207,244,263,292,332,374,476,520,628,667,674,694 'implementation-friend':331 'includ':348,463,621,648 'independ':543,551,557 'indic':642 'integr':368 'interdepend':564 'interfac':363,392 'issu':5,415,424,446,506,515,527,532,538,575,579,587,608,613,624,632,653 'item':201 'journey':172 'justif':499 'keep':328 'key':376 'know':399 'label':434,640 'lack':156 'larg':601 'later':708 'level':254,266 'link':528,633 'list':194,490,504,513 'logic':673 'look':159 'main':86 'maintain':726 'manag':27,605 'mani':236 'map':567 'matrix':229 'maxim':556 'mention':132,162,441 'minim':692 'miss':16,43,166,177,197,217,276 'mission':243 'model':717 'modifi':381 'modul':94 'modules/files':377 'must':407 'mvp':321,442 'name':286,450 'need':252,359,473 'negat':256 'nice':186 'nice-to-hav':185 'note':205,676 'one':510,517 'open':712 'open-sourc':711 'optim':542 'order':675 'organ':64 'output':190,267 'overal':582 'overview':339,451 'parent':537,578 'pass':412 'pattern':123 'phase':56,142,220,300,417,661 'philosoph':314 'philosophi':443 'placehold':104,153 'plan':375,477,657 'point':88,369 'potenti':196,255,678 'practic':309 'prerequisit':647 'present':269 'primari':111 'priorit':18,45,219,303,501,734 'prioriti':258,275,438,498 'problem':118,342 'process':685 'product':26 'project':54,59,75,115,738 'provid':284 'purpos':112,459 'question':107 'read':65 'readme.md':67 'real':157 'refactor':553 'refer':209 'relationship':596,638 'relev':445 'rememb':682 'repres':614 'requir':249,356,470,492 'resourc':248 'review':57,545,660 'risk':253,265 'robust':167 'scale':232 'scope':340,460 'score':223,228,281 'show':385 'simpl':382,484 'simplic':316,687 'size':521 'skill' 'skill-gen-specs-as-issues' 'small/medium/large':524 'smaller':604 'softwar':737 'solv':121,345 'sourc':713 'source-github' 'spec':3 'specif':23,32,50,298,310,330,337,405,420,429,471,547,554,602,625,665 'specifi':732 'sprint':656 'start':690 'status':83,208,288,644 'step':178,479,481 'step-by-step':478 'strateg':239,261 'stream':559 'structur':60,390,448 'sub':526,531,586,607,612,623 'sub-issu':525,530,585,606,611,622 'suggest':671 'summar':662 'syntax':634 'systemat':12,39 'technic':246,355,469,472 'templat':447 'test':98,410 'thought':742 'throughout':683 'titl':427 'top':271 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'truli':550 'ui':91,365 'unavoid':571 'understand':55,62,73,100 'use':630 'user':117,171,214,233,237,259,361,744 'user-cent':743 'user-fac':360 'viabl':693 'way':746 'work':408,540,558,620,696 'workflow':7,34,719 'workload':597","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-05-18T18:52:12.616Z"},{"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-05-07T22:40:18.775Z"}],"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","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":"abbce0e3b6013b28fe274b5039b337edc64589be","skill_md_path":"skills/gen-specs-as-issues/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/gen-specs-as-issues"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"gen-specs-as-issues","description":"This workflow guides you through a systematic approach to identify missing features, prioritize them, and create detailed specifications for implementation."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/gen-specs-as-issues"},"updatedAt":"2026-05-18T18:52:12.616Z"}}