{"id":"b7eb40be-87fe-41ea-8e3b-16f86a8aa9ed","shortId":"HTFqbp","kind":"skill","title":"create-issue","tagline":"This skill should be used when the user asks to \"create an issue\", \"file a bug\", \"create a feature request\", \"open a GitHub issue\", \"report a bug\", \"request a feature\", \"create a task\", \"break this into issues\", or describes a feature/bug they want tracked in GitHub. Guides inter","description":"# Create GitHub Issue\n\nCreate well-structured GitHub issues from user descriptions through interactive clarification.\n\n## Repository Detection\n\nDetect the repository from the current git remote:\n\n```bash\nREPO=$(gh repo view --json nameWithOwner -q '.nameWithOwner')\n# Splits into OWNER and REPO_NAME\n```\n\nIf detection fails, ask the user for the target repository.\n\n## Process\n\n### Step 1: Understand the Request\n\nWhen the user describes a feature or bug, gather context through clarifying questions. Do NOT create the issue immediately.\n\n**For features, clarify:**\n- What is the user-facing goal? (not implementation details)\n- What are the acceptance criteria? (how to verify it works)\n- Are there UI/UX implications?\n- What existing functionality does this relate to?\n- Priority and scope constraints\n\n**For bugs, clarify:**\n- Steps to reproduce\n- Expected vs actual behavior\n- Environment (prod, staging, PR preview)\n- Severity (blocking, degraded, cosmetic)\n- Any error messages or logs\n\nAsk 2-3 focused questions per round. Stop when there is enough information to write a clear issue.\n\n### Step 2: Draft the Issue\n\nUse the appropriate template based on issue type. For full template content, consult **`references/issue-templates.md`**.\n\nBoth templates include these required sections:\n- **Summary** / **Motivation** (feature) or **Steps to Reproduce** (bug)\n- **Requirements** with checkboxes (feature) or **Expected/Actual Behavior** (bug)\n- **Testing Requirements** (mandatory TDD section: test cases doc, unit tests, E2E tests)\n- **Acceptance Criteria** with checkboxes\n- **Dependencies** section for issue ordering\n\n### Step 2.5: Detect & Attach Workspace Changes\n\nAfter drafting the issue, check the workspace for local changes that may provide useful context for the autonomous dev agent. For the complete detection, attachment, and cleanup procedure, consult **`references/workspace-changes.md`**.\n\nSummary:\n1. Run `git status --short` — skip if no changes\n2. Summarize changes and ask user for confirmation\n3. Choose strategy based on diff size: inline (< 500 lines), branch push (>= 500 lines), or file list fallback\n4. Add a `## Pre-existing Changes` section to the issue body\n5. Optionally clean up local changes after attachment\n\n### Step 3: Confirm with User\n\nPresent the draft issue to the user with:\n1. Proposed title (concise, descriptive)\n2. Full issue body (including Pre-existing Changes section if applicable)\n3. Proposed labels\n4. Whether to add `autonomous` label\n\nUse AskUserQuestion to confirm:\n- \"Does this issue look correct? Should I create it?\"\n- Ask about autonomous label: whether AI should handle this automatically\n\n### Step 4: Create the Issue\n\nUse GitHub MCP tools or `gh` CLI to create the issue with:\n- `title`: The confirmed title\n- `body`: The confirmed body\n- `labels`: Appropriate labels (see Label Guide below)\n\nReport the created issue URL to the user.\n\n**If branch push was deferred (large diff strategy):**\n\nAfter the issue is created and the issue number is known:\n1. Execute the branch push commands from Step 2.5.5 using the actual issue number\n2. Update the issue body to include the branch reference section\n\n## Label Guide\n\n| Label | When to Apply |\n|-------|-------------|\n| `bug` | Bug reports |\n| `enhancement` | Feature requests |\n| `autonomous` | User confirms AI should handle dev/test/review/merge automatically |\n| `no-auto-close` | Used with `autonomous` -- AI handles dev/test/review but stops before merge, requiring manual approval |\n| `documentation` | Documentation-only changes |\n| `good first issue` | Simple, well-scoped tasks |\n\n## Autonomous Label Decision\n\nAfter drafting the issue, explicitly ask the user whether to add the `autonomous` label.\n\nProvide guidance on when `autonomous` is appropriate:\n- **Good fit**: Well-defined scope, clear acceptance criteria, follows existing patterns, no ambiguous design decisions\n- **Poor fit**: Requires significant architecture decisions, needs user input during development, involves sensitive infrastructure changes, exploratory/research tasks\n\nFrame the question as:\n> \"Should this issue be handled by the autonomous development pipeline? The AI will automatically develop, test, review, and merge the changes. This works best for well-defined tasks with clear acceptance criteria.\"\n\n**If the user selects `autonomous`, also ask about `no-auto-close`:**\n\n> \"Should this issue also have the `no-auto-close` label? With this label, the AI will handle development, testing, and review, but will **stop before merging** -- you'll be notified to make the final merge decision. This is recommended for sensitive infrastructure changes, features needing product sign-off, or experimental work.\"\n\n**Label interaction summary:**\n- `autonomous` alone = AI handles dev/test/review **and** auto-merges on pass\n- `autonomous` + `no-auto-close` = AI handles dev/test/review but **stops before merge**, notifying the owner for manual approval\n\n## Writing Guidelines\n\n- **Title**: Start with verb, be specific. \"Add pagination to plans list page\" not \"Plans page improvement\"\n- **Body**: Write for an AI developer who has access to the full codebase but no verbal context from this conversation\n- **Acceptance criteria**: Must be objectively verifiable, not subjective\n- **Scope**: Prefer smaller, focused issues over large multi-part ones\n- **References**: Link to related issues, PRD sections, or code paths when relevant\n- **Dependencies**: When creating multiple related issues, populate the `## Dependencies` section with links to blocking issues. Create issues in dependency order so earlier issue numbers are available for later ones. The dispatcher will skip issues whose dependencies are still open.\n- **Testing Requirements**: ALWAYS include the \"Testing Requirements\" section. The dev agent follows the project's TDD workflow but has been observed to skip E2E tests or test-case docs when the issue doesn't explicitly call them out. Be specific about:\n  - Key scenarios each test type must cover (2-4 bullet points)\n  - For bugs: the regression test must fail before the fix and pass after\n\n## Multi-Issue Creation\n\nWhen breaking a large feature into multiple issues:\n\n1. **Create issues in dependency order** — issues with no dependencies first, then issues that depend on them. This ensures issue numbers are known when writing dependency references.\n2. **Populate the `## Dependencies` section** in each issue body with `#N` links to blocking issues.\n3. **Use a consistent naming scheme** — prefix titles with the project/feature name for easy filtering (e.g., \"MyProject: Add DynamoDB infrastructure\").\n4. **Cross-reference the plan** — if an implementation plan exists, link each issue to the relevant plan tasks/chunks.\n5. **The dispatcher skips blocked issues** — issues with open dependencies in the `## Dependencies` section are ignored by the autonomous dispatcher until all dependencies are resolved (closed/merged).\n\n---\n\n## References\n\nFor detailed content, consult:\n- **`references/issue-templates.md`** -- Full feature and bug issue templates with all required sections\n- **`references/workspace-changes.md`** -- Complete workspace change detection, attachment strategies, and cleanup procedure","tags":["create","issue","autonomous","dev","team","zxkane","agent-skills","ai-agents","ai-code-review","autonomous-coding","autonomous-dev-team","ci-cd"],"capabilities":["skill","source-zxkane","skill-create-issue","topic-agent-skills","topic-ai-agents","topic-ai-code-review","topic-autonomous-coding","topic-autonomous-dev-team","topic-ci-cd","topic-claude-code","topic-claude-code-hooks","topic-code-review-automation","topic-codex-cli","topic-coding-agents","topic-devops-automation"],"categories":["autonomous-dev-team"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/zxkane/autonomous-dev-team/create-issue","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add zxkane/autonomous-dev-team","source_repo":"https://github.com/zxkane/autonomous-dev-team","install_from":"skills.sh"}},"qualityScore":"0.457","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 15 github stars · SKILL.md body (7,228 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-04-22T13:03:20.606Z","embedding":null,"createdAt":"2026-04-19T00:40:47.465Z","updatedAt":"2026-04-22T13:03:20.606Z","lastSeenAt":"2026-04-22T13:03:20.606Z","tsv":"'-3':191 '-4':906 '1':104,306,374,482,934 '2':190,208,315,379,496,905,961 '2.5':270 '2.5.5':490 '3':323,362,391,976 '4':341,394,424,996 '5':353,1015 '500':331,335 'accept':143,260,588,649,786 'access':774 'actual':173,493 'add':342,397,570,756,993 'agent':294,866 'ai':418,522,534,629,678,721,735,770 'alon':720 'also':656,666 'alway':858 'ambigu':594 'appli':512 'applic':390 'appropri':214,449,580 'approv':543,747 'architectur':601 'ask':12,95,189,319,413,565,657 'askuserquest':401 'attach':272,299,360,1062 'auto':529,661,671,726,733 'auto-merg':725 'automat':422,526,631 'autonom':292,398,415,519,533,557,572,578,625,655,719,730,1033 'avail':842 'base':216,326 'bash':77 'behavior':174,246 'best':641 'block':181,830,974,1019 'bodi':352,382,444,447,500,766,969 'branch':333,464,485,504 'break':37,927 'bug':19,30,115,166,239,247,513,514,910,1050 'bullet':907 'call':892 'case':254,884 'chang':274,284,314,317,347,358,387,548,611,638,706,1060 'check':279 'checkbox':242,263 'choos':324 'clarif':66 'clarifi':119,129,167 'clean':355 'cleanup':301,1065 'clear':205,587,648 'cli':434 'close':530,662,672,734 'closed/merged':1040 'code':813 'codebas':778 'command':487 'complet':297,1058 'concis':377 'confirm':322,363,403,442,446,521 'consist':979 'constraint':164 'consult':224,303,1045 'content':223,1044 'context':117,289,782 'convers':785 'correct':408 'cosmet':183 'cover':904 'creat':2,14,20,34,52,55,123,411,425,436,457,475,819,832,935 'create-issu':1 'creation':925 'criteria':144,261,589,650,787 'cross':998 'cross-refer':997 'current':74 'decis':559,596,602,699 'defer':467 'defin':585,645 'degrad':182 'depend':264,817,825,835,852,938,943,948,959,964,1024,1027,1037 'describ':42,111 'descript':63,378 'design':595 'detail':139,1043 'detect':68,69,93,271,298,1061 'dev':293,865 'dev/test/review':536,723,737 'dev/test/review/merge':525 'develop':607,626,632,681,771 'diff':328,469 'dispatch':847,1017,1034 'doc':255,885 'document':544,546 'documentation-on':545 'doesn':889 'draft':209,276,368,561 'dynamodb':994 'e.g':991 'e2e':258,879 'earlier':838 'easi':989 'enhanc':516 'enough':200 'ensur':952 'environ':175 'error':185 'execut':483 'exist':155,346,386,591,1006 'expect':171 'expected/actual':245 'experiment':714 'explicit':564,891 'exploratory/research':612 'face':135 'fail':94,915 'fallback':340 'featur':22,33,113,128,234,243,517,707,930,1048 'feature/bug':44 'file':17,338 'filter':990 'final':697 'first':550,944 'fit':582,598 'fix':918 'focus':192,797 'follow':590,867 'frame':614 'full':221,380,777,1047 'function':156 'gather':116 'gh':79,433 'git':75,308 'github':26,49,53,59,429 'goal':136 'good':549,581 'guid':50,453,508 'guidanc':575 'guidelin':749 'handl':420,524,535,622,680,722,736 'ignor':1030 'immedi':126 'implement':138,1004 'implic':153 'improv':765 'includ':228,383,502,859 'inform':201 'infrastructur':610,705,995 'inlin':330 'input':605 'inter':51 'interact':65,717 'involv':608 'issu':3,16,27,40,54,60,125,206,211,218,267,278,351,369,381,406,427,438,458,473,478,494,499,551,563,620,665,798,809,822,831,833,839,850,888,924,933,936,940,946,953,968,975,1009,1020,1021,1051 'json':82 'key':898 'known':481,956 'label':393,399,416,448,450,452,507,509,558,573,673,676,716 'larg':468,800,929 'later':844 'line':332,336 'link':806,828,972,1007 'list':339,760 'll':691 'local':283,357 'log':188 'look':407 'make':695 'mandatori':250 'manual':542,746 'may':286 'mcp':430 'merg':540,636,689,698,727,741 'messag':186 'motiv':233 'multi':802,923 'multi-issu':922 'multi-part':801 'multipl':820,932 'must':788,903,914 'myproject':992 'n':971 'name':91,980,987 'namewithown':83,85 'need':603,708 'no-auto-clos':527,659,669,731 'notifi':693,742 'number':479,495,840,954 'object':790 'observ':876 'one':804,845 'open':24,855,1023 'option':354 'order':268,836,939 'owner':88,744 'page':761,764 'pagin':757 'part':803 'pass':729,920 'path':814 'pattern':592 'per':194 'pipelin':627 'plan':759,763,1001,1005,1013 'point':908 'poor':597 'popul':823,962 'pr':178 'prd':810 'pre':345,385 'pre-exist':344,384 'prefer':795 'prefix':982 'present':366 'preview':179 'prioriti':161 'procedur':302,1066 'process':102 'prod':176 'product':709 'project':869 'project/feature':986 'propos':375,392 'provid':287,574 'push':334,465,486 'q':84 'question':120,193,616 'recommend':702 'refer':505,805,960,999,1041 'references/issue-templates.md':225,1046 'references/workspace-changes.md':304,1057 'regress':912 'relat':159,808,821 'relev':816,1012 'remot':76 'repo':78,80,90 'report':28,455,515 'repositori':67,71,101 'reproduc':170,238 'request':23,31,107,518 'requir':230,240,249,541,599,857,862,1055 'resolv':1039 'review':634,684 'round':195 'run':307 'scenario':899 'scheme':981 'scope':163,555,586,794 'section':231,252,265,348,388,506,811,826,863,965,1028,1056 'see':451 'select':654 'sensit':609,704 'sever':180 'short':310 'sign':711 'sign-off':710 'signific':600 'simpl':552 'size':329 'skill':5 'skill-create-issue' 'skip':311,849,878,1018 'smaller':796 'source-zxkane' 'specif':755,896 'split':86 'stage':177 'start':751 'status':309 'step':103,168,207,236,269,361,423,489 'still':854 'stop':196,538,687,739 'strategi':325,470,1063 'structur':58 'subject':793 'summar':316 'summari':232,305,718 'target':100 'task':36,556,613,646 'tasks/chunks':1014 'tdd':251,871 'templat':215,222,227,1052 'test':248,253,257,259,633,682,856,861,880,883,901,913 'test-cas':882 'titl':376,440,443,750,983 'tool':431 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-code-review' 'topic-autonomous-coding' 'topic-autonomous-dev-team' 'topic-ci-cd' 'topic-claude-code' 'topic-claude-code-hooks' 'topic-code-review-automation' 'topic-codex-cli' 'topic-coding-agents' 'topic-devops-automation' 'track':47 'type':219,902 'ui/ux':152 'understand':105 'unit':256 'updat':497 'url':459 'use':8,212,288,400,428,491,531,977 'user':11,62,97,110,134,320,365,372,462,520,567,604,653 'user-fac':133 'verb':753 'verbal':781 'verifi':147,791 'view':81 'vs':172 'want':46 'well':57,554,584,644 'well-defin':583,643 'well-scop':553 'well-structur':56 'whether':395,417,568 'whose':851 'work':149,640,715 'workflow':872 'workspac':273,281,1059 'write':203,748,767,958","prices":[{"id":"146a6419-1a0e-4e40-b65e-bc673262046f","listingId":"b7eb40be-87fe-41ea-8e3b-16f86a8aa9ed","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"zxkane","category":"autonomous-dev-team","install_from":"skills.sh"},"createdAt":"2026-04-19T00:40:47.465Z"}],"sources":[{"listingId":"b7eb40be-87fe-41ea-8e3b-16f86a8aa9ed","source":"github","sourceId":"zxkane/autonomous-dev-team/create-issue","sourceUrl":"https://github.com/zxkane/autonomous-dev-team/tree/main/skills/create-issue","isPrimary":false,"firstSeenAt":"2026-04-19T00:40:47.465Z","lastSeenAt":"2026-04-22T13:03:20.606Z"}],"details":{"listingId":"b7eb40be-87fe-41ea-8e3b-16f86a8aa9ed","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"zxkane","slug":"create-issue","github":{"repo":"zxkane/autonomous-dev-team","stars":15,"topics":["agent-skills","ai-agents","ai-code-review","autonomous-coding","autonomous-dev-team","ci-cd","claude-code","claude-code-hooks","code-review-automation","codex-cli","coding-agents","devops-automation","github-automation","github-issues","kiro-cli","llm-agents","openclaw","pull-request-automation","tdd","template-project"],"license":null,"html_url":"https://github.com/zxkane/autonomous-dev-team","pushed_at":"2026-04-20T15:45:13Z","description":"Turns GitHub issues into merged PRs with zero human intervention. Powered by OpenClaw, supports Claude Code, Codex CLI, and Kiro CLI.","skill_md_sha":"026b11c4d65f7fc04ad4e4f18b59e855489d3271","skill_md_path":"skills/create-issue/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/zxkane/autonomous-dev-team/tree/main/skills/create-issue"},"layout":"multi","source":"github","category":"autonomous-dev-team","frontmatter":{"name":"create-issue","description":"This skill should be used when the user asks to \"create an issue\", \"file a bug\", \"create a feature request\", \"open a GitHub issue\", \"report a bug\", \"request a feature\", \"create a task\", \"break this into issues\", or describes a feature/bug they want tracked in GitHub. Guides interactive issue creation with structured templates, workspace change attachment, and optional autonomous label for the automated pipeline."},"skills_sh_url":"https://skills.sh/zxkane/autonomous-dev-team/create-issue"},"updatedAt":"2026-04-22T13:03:20.606Z"}}