{"id":"40d42297-ff8e-4188-8dd4-d1406e42432a","shortId":"ksDwZn","kind":"skill","title":"github","tagline":"Work with GitHub for branches, PRs, code review, issues, projects, and discussions.","description":"# GitHub\n\nYou use GitHub as part of your workflow. The repo is `byronxlg/skillfold`.\n\n## Agent Identity\n\nAll agents share one GitHub account. Tag every public message (issue bodies, PR descriptions, comments, review bodies) with your agent name at the top so the audit trail is clear:\n\n```\n**[agent-name]**\n\nYour message here...\n```\n\n## Branches and PRs\n\n- Create a feature branch for each piece of work\n- Open a pull request with a clear title and description\n- Use `gh pr create` to open PRs from the command line\n- Use `gh pr view` and `gh pr diff` to review PRs\n- Use `gh pr merge` to merge approved PRs\n- Link PRs to issues: `gh pr create --body \"Closes #ISSUE_NUMBER\"`\n\n## Code Review\n\n- Review PRs by reading the diff with `gh pr diff <number>`\n- Leave review comments with `gh pr review <number> --approve` or `--request-changes --body \"...\"`\n- Check PR status with `gh pr checks <number>`\n- Read review state: `gh pr view <number> --json reviews --jq '.reviews[-1] | {state, body}'`\n\n## Issues\n\n- Create an issue: `gh issue create --repo byronxlg/skillfold --title \"...\" --body \"...\"`\n- Create with labels: `gh issue create --repo byronxlg/skillfold --title \"...\" --body \"...\" --label \"task\"`\n- List issues: `gh issue list --repo byronxlg/skillfold`\n- Filter by label: `gh issue list --repo byronxlg/skillfold --label \"task\"`\n- View an issue: `gh issue view NUMBER --repo byronxlg/skillfold`\n- View with comments: `gh issue view NUMBER --repo byronxlg/skillfold --comments`\n- Close an issue: `gh issue close NUMBER --repo byronxlg/skillfold`\n- Add a comment: `gh issue comment NUMBER --repo byronxlg/skillfold --body \"...\"`\n\n**Important:** Before planning or working on an issue, always read its comments with `--comments`. Comments contain feedback, clarifications, and constraints that must inform the work.\n\n## Project Board\n\nThe team uses GitHub Project #4 (`skillfold`) as the source of truth for task tracking. Every issue and PR should be on the board with correct field values.\n\n**Project ID:** `PVT_kwHOBBJnl84BSS4t`\n\n### Fields\n\n**Status** (field: `PVTSSF_lAHOBBJnl84BSS4tzg_3zuk`)\n\n| Status | Option ID | When to use |\n|--------|-----------|-------------|\n| Backlog | `e2a069f9` | Roadmap items, not yet prioritized |\n| Todo | `42049e09` | Prioritized, ready for next cycle |\n| In Progress | `f59e1488` | Actively being worked |\n| In Review | `6556c2f2` | PR open, awaiting review |\n| Blocked | `973f86bf` | Waiting on external dependency |\n| Done | `cf220d76` | Shipped and closed |\n\n**Agent** (field: `PVTSSF_lAHOBBJnl84BSS4tzg_6hkc`)\n\n| Agent | Option ID |\n|-------|-----------|\n| strategist | `4be20df1` |\n| architect | `a598e901` |\n| engineer | `d39473bf` |\n| reviewer | `bc8fa2bd` |\n| marketer | `d7953c0e` |\n| human | `d5c96d9f` |\n\n**Priority** (field: `PVTSSF_lAHOBBJnl84BSS4tzg_6hkg`)\n\n| Priority | Option ID |\n|----------|-----------|\n| P0 - Critical | `55c372c9` |\n| P1 - High | `39bccf40` |\n| P2 - Normal | `c0e46bdb` |\n| P3 - Low | `b07d72a2` |\n\n**Due Date** (field: `PVTF_lAHOBBJnl84BSS4tzg_6hkk`, type: date, format: `YYYY-MM-DD`)\n\n### Board Operations\n\nAdd an item:\n```\ngh project item-add 4 --owner byronxlg --url ISSUE_OR_PR_URL --format json\n```\n\nList all items (returns JSON with item IDs and field values):\n```\ngh project item-list 4 --owner byronxlg --format json\n```\n\nSet a field value:\n```\ngh project item-edit --project-id PVT_kwHOBBJnl84BSS4t --id ITEM_ID --field-id FIELD_ID --single-select-option-id OPTION_ID\n```\n\nSet a date:\n```\ngh project item-edit --project-id PVT_kwHOBBJnl84BSS4t --id ITEM_ID --field-id PVTF_lAHOBBJnl84BSS4tzg_6hkk --date YYYY-MM-DD\n```\n\n### Board Workflow\n\nWhen creating an issue, add it to the board and set Status, Agent, and Priority:\n1. Create the issue with `gh issue create`\n2. Add to board: `gh project item-add 4 --owner byronxlg --url ISSUE_URL --format json`\n3. Parse the item ID from the JSON response\n4. Set Status, Agent, and Priority with `gh project item-edit`\n\nWhen starting work on an issue: set Status to In Progress.\nWhen opening a PR: set Status to In Review.\nWhen blocked: set Status to Blocked.\nWhen done: set Status to Done.\n\n## Discussions\n\nDiscussions use the GitHub GraphQL API via `gh api graphql`. Repo ID: `R_kgDORrIFQw`.\n\n### Categories\n\n| Category | ID | Purpose |\n|----------|----|---------|\n| Strategy | `DIC_kwDORrIFQ84C42C8` | Strategist direction, architect plans |\n| Engineering | `DIC_kwDORrIFQ84C46kq` | Technical feedback, design discussions |\n| Human | `DIC_kwDORrIFQ84C46lh` | Human input, guidance, and feedback for the strategist |\n| Announcements | `DIC_kwDORrIFQ84C42C7` | Releases, changelog summaries |\n\n### Commands\n\n- List discussions:\n  ```\n  gh api graphql -f query='{ repository(owner: \"byronxlg\", name: \"skillfold\") { discussions(first: 10, orderBy: {field: CREATED_AT, direction: DESC}) { nodes { number title category { name } createdAt } } } }'\n  ```\n- List by category (filter by category ID):\n  ```\n  gh api graphql -f query='{ repository(owner: \"byronxlg\", name: \"skillfold\") { discussions(first: 10, categoryId: \"CATEGORY_ID\", orderBy: {field: CREATED_AT, direction: DESC}) { nodes { number title createdAt } } } }'\n  ```\n- View a discussion:\n  ```\n  gh api graphql -f query='{ repository(owner: \"byronxlg\", name: \"skillfold\") { discussion(number: NUMBER) { title body comments(first: 20) { nodes { body author { login } } } } } }'\n  ```\n- Create a discussion:\n  ```\n  gh api graphql -f query='mutation { createDiscussion(input: {repositoryId: \"R_kgDORrIFQw\", categoryId: \"CATEGORY_ID\", title: \"...\", body: \"...\"}) { discussion { number url } } }'\n  ```\n- Get a discussion's node ID (needed for commenting):\n  ```\n  gh api graphql -f query='{ repository(owner: \"byronxlg\", name: \"skillfold\") { discussion(number: NUMBER) { id } } }'\n  ```\n- Comment on a discussion:\n  ```\n  gh api graphql -f query='mutation { addDiscussionComment(input: {discussionId: \"DISCUSSION_NODE_ID\", body: \"...\"}) { comment { url } } }'\n  ```","tags":["github","skillfold","byronxlg","agent-framework","agent-skills","ai-agents","claude-code","compiler","multi-agent","orchestrator","pipeline","skill-composition"],"capabilities":["skill","source-byronxlg","skill-github","topic-agent-framework","topic-agent-skills","topic-ai-agents","topic-claude-code","topic-compiler","topic-multi-agent","topic-orchestrator","topic-pipeline","topic-skill-composition","topic-typescript","topic-yaml"],"categories":["skillfold"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/byronxlg/skillfold/github","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add byronxlg/skillfold","source_repo":"https://github.com/byronxlg/skillfold","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (5,951 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-18T19:14:27.522Z","embedding":null,"createdAt":"2026-05-18T13:22:08.140Z","updatedAt":"2026-05-18T19:14:27.522Z","lastSeenAt":"2026-05-18T19:14:27.522Z","tsv":"'-1':170 '1':527 '10':670,702 '2':535 '20':736 '3':552 '39bccf40':393 '3zuk':315 '4':283,423,449,544,561 '42049e09':330 '4be20df1':369 '55c372c9':390 '6556c2f2':344 '6hkc':364 '6hkg':384 '6hkk':405,504 '973f86bf':350 'a598e901':371 'account':34 'activ':339 'add':241,415,422,516,536,543 'adddiscussioncom':796 'agent':27,30,48,60,360,365,524,564 'agent-nam':59 'alway':259 'announc':649 'api':611,614,659,691,720,745,773,791 'approv':115,147 'architect':370,629 'audit':55 'author':739 'await':347 'b07d72a2':399 'backlog':322 'bc8fa2bd':375 'block':349,594,598 'board':277,301,413,510,520,538 'bodi':40,45,124,152,172,183,193,250,733,738,759,802 'branch':6,65,71 'byronxlg':425,451,546,665,697,726,779 'byronxlg/skillfold':26,181,191,202,210,221,230,240,249 'c0e46bdb':396 'categori':620,621,680,685,688,704,756 'categoryid':703,755 'cf220d76':356 'chang':151 'changelog':653 'check':153,159 'clarif':268 'clear':58,83 'close':125,232,237,359 'code':8,128 'command':96,655 'comment':43,142,224,231,243,246,262,264,265,734,771,786,803 'constraint':270 'contain':266 'correct':303 'creat':68,90,123,174,179,184,189,513,528,534,673,708,741 'createdat':682,715 'creatediscuss':750 'critic':389 'cycl':335 'd39473bf':373 'd5c96d9f':379 'd7953c0e':377 'date':401,407,485,505 'dd':412,509 'depend':354 'desc':676,711 'descript':42,86 'design':636 'dic':625,632,639,650 'diff':105,135,139 'direct':628,675,710 'discuss':13,605,606,637,657,668,700,718,729,743,760,765,782,789,799 'discussionid':798 'done':355,600,604 'due':400 'e2a069f9':323 'edit':462,490,572 'engin':372,631 'everi':36,293 'extern':353 'f':661,693,722,747,775,793 'f59e1488':338 'featur':70 'feedback':267,635,645 'field':304,310,312,361,381,402,442,456,472,474,500,672,707 'field-id':471,499 'filter':203,686 'first':669,701,735 'format':408,431,452,550 'get':763 'gh':88,99,103,110,121,137,144,157,163,177,187,198,206,216,225,235,244,418,444,458,486,532,539,568,613,658,690,719,744,772,790 'github':1,4,14,17,33,281,609 'graphql':610,615,660,692,721,746,774,792 'guidanc':643 'high':392 'human':378,638,641 'id':307,318,367,387,440,465,468,470,473,475,480,482,493,496,498,501,556,617,622,689,705,757,768,785,801 'ident':28 'import':251 'inform':273 'input':642,751,797 'issu':10,39,120,126,173,176,178,188,197,199,207,215,217,226,234,236,245,258,294,427,515,530,533,548,578 'item':325,417,421,435,439,447,461,469,489,497,542,555,571 'item-add':420,541 'item-edit':460,488,570 'item-list':446 'jq':168 'json':166,432,437,453,551,559 'kgdorrifqw':619,754 'kwdorrifq84c42c7':651 'kwdorrifq84c42c8':626 'kwdorrifq84c46kq':633 'kwdorrifq84c46lh':640 'kwhobbjnl84bss4t':309,467,495 'label':186,194,205,211 'lahobbjnl84bss4tzg':314,363,383,404,503 'leav':140 'line':97 'link':117 'list':196,200,208,433,448,656,683 'login':740 'low':398 'market':376 'merg':112,114 'messag':38,63 'mm':411,508 'must':272 'mutat':749,795 'name':49,61,666,681,698,727,780 'need':769 'next':334 'node':677,712,737,767,800 'normal':395 'number':127,219,228,238,247,678,713,730,731,761,783,784 'one':32 'open':77,92,346,585 'oper':414 'option':317,366,386,479,481 'orderbi':671,706 'owner':424,450,545,664,696,725,778 'p0':388 'p1':391 'p2':394 'p3':397 'pars':553 'part':19 'piec':74 'plan':253,630 'pr':41,89,100,104,111,122,138,145,154,158,164,296,345,429,587 'priorit':328,331 'prioriti':380,385,526,566 'progress':337,583 'project':11,276,282,306,419,445,459,464,487,492,540,569 'project-id':463,491 'prs':7,67,93,108,116,118,131 'public':37 'pull':79 'purpos':623 'pvt':308,466,494 'pvtf':403,502 'pvtssf':313,362,382 'queri':662,694,723,748,776,794 'r':618,753 'read':133,160,260 'readi':332 'releas':652 'repo':24,180,190,201,209,220,229,239,248,616 'repositori':663,695,724,777 'repositoryid':752 'request':80,150 'request-chang':149 'respons':560 'return':436 'review':9,44,107,129,130,141,146,161,167,169,343,348,374,592 'roadmap':324 'select':478 'set':454,483,522,562,579,588,595,601 'share':31 'ship':357 'singl':477 'single-select-option-id':476 'skill' 'skill-github' 'skillfold':284,667,699,728,781 'sourc':287 'source-byronxlg' 'start':574 'state':162,171 'status':155,311,316,523,563,580,589,596,602 'strategi':624 'strategist':368,627,648 'summari':654 'tag':35 'task':195,212,291 'team':279 'technic':634 'titl':84,182,192,679,714,732,758 'todo':329 'top':52 'topic-agent-framework' 'topic-agent-skills' 'topic-ai-agents' 'topic-claude-code' 'topic-compiler' 'topic-multi-agent' 'topic-orchestrator' 'topic-pipeline' 'topic-skill-composition' 'topic-typescript' 'topic-yaml' 'track':292 'trail':56 'truth':289 'type':406 'url':426,430,547,549,762,804 'use':16,87,98,109,280,321,607 'valu':305,443,457 'via':612 'view':101,165,213,218,222,227,716 'wait':351 'work':2,76,255,275,341,575 'workflow':22,511 'yet':327 'yyyi':410,507 'yyyy-mm-dd':409,506","prices":[{"id":"871f911b-e45e-4b36-a68e-0cf5f6b22f36","listingId":"40d42297-ff8e-4188-8dd4-d1406e42432a","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"byronxlg","category":"skillfold","install_from":"skills.sh"},"createdAt":"2026-05-18T13:22:08.140Z"}],"sources":[{"listingId":"40d42297-ff8e-4188-8dd4-d1406e42432a","source":"github","sourceId":"byronxlg/skillfold/github","sourceUrl":"https://github.com/byronxlg/skillfold/tree/main/skills/github","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:08.140Z","lastSeenAt":"2026-05-18T19:14:27.522Z"}],"details":{"listingId":"40d42297-ff8e-4188-8dd4-d1406e42432a","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"byronxlg","slug":"github","github":{"repo":"byronxlg/skillfold","stars":6,"topics":["agent-framework","agent-skills","ai-agents","claude-code","compiler","multi-agent","orchestrator","pipeline","skill-composition","typescript","yaml"],"license":"mit","html_url":"https://github.com/byronxlg/skillfold","pushed_at":"2026-05-02T04:13:05Z","description":"Configuration language and compiler for multi-agent AI pipelines. Compiles YAML config into standard SKILL.md files.","skill_md_sha":"cf24b8fd91cd13927530e60425aedf44a18ded8d","skill_md_path":"skills/github/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/byronxlg/skillfold/tree/main/skills/github"},"layout":"multi","source":"github","category":"skillfold","frontmatter":{"name":"github","description":"Work with GitHub for branches, PRs, code review, issues, projects, and discussions."},"skills_sh_url":"https://skills.sh/byronxlg/skillfold/github"},"updatedAt":"2026-05-18T19:14:27.522Z"}}