[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78AM0C8TCK8GPJ0A8DXCKDC":3,"skill-same:01M78AM0C8TCK8GPJ0A8DXCKDC":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":14,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M78AM0C8TCK8GPJ0A8DXCKDC","codebase-recon",null,"Use when entering an unfamiliar codebase, onboarding to a new project, or wanting to assess codebase health before reading code — analyzes git history to reveal hotspots, risk areas, team structure, and development momentum","shabanakhtar\u002Fai-agent-skills","shabanakhtar","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F227051719?v=4","01M78AKN2JXC35SX7K2AHZ3RJT","Shaban Akhtar","01M78AKN3AJNZPYGR17V4DVV5K",0,"MIT","https:\u002F\u002Fgithub.com\u002Fshabanakhtar\u002Fai-agent-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fcodebase-recon\u002Fcodex\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: codebase-recon\ndescription: >\n  Use when entering an unfamiliar codebase, onboarding to a new project,\n  or wanting to assess codebase health before reading code — analyzes git\n  history to reveal hotspots, risk areas, team structure, and development\n  momentum\ncompatibility: Requires git. Works in any terminal-based coding agent.\nmetadata:\n  author: yujiachen-y\n  version: \"1.0\"\n  inspired-by: https:\u002F\u002Fpiechowski.io\u002Fpost\u002Fgit-commands-before-reading-code\u002F\n---\n\n# Codebase Recon\n\nAnalyze git history to understand a codebase before reading any code. Reveals project health, risk areas, team structure, and development momentum.\n\nInspired by [\"The Git Commands I Run Before Reading Any Code\"](https:\u002F\u002Fpiechowski.io\u002Fpost\u002Fgit-commands-before-reading-code\u002F) by [Ally Piechowski](https:\u002F\u002Fgithub.com\u002Fgrepsedawk).\n\n## Phase 1: Probe\n\nBefore running analysis, determine repo scale to calibrate time windows and result counts.\n\nRun this single shell command to collect repo vitals:\n\n```sh\necho \"COMMITS=$(git rev-list --count HEAD)\" && \\\necho \"FIRST_COMMIT=$(git log --reverse --format='%ad' --date=short | head -1)\" && \\\necho \"LATEST_COMMIT=$(git log --format='%ad' --date=short | head -1)\" && \\\necho \"BRANCHES=$(git branch -a | wc -l | tr -d ' ')\"\n```\n\nUse the commit count to set parameters for Phase 2:\n\n| Repo Size | Commits | `WINDOW` (--since) | `N` (--head) |\n|-----------|---------|---------------------|--------------|\n| Small     | \u003C500    | (omit --since)      | 10           |\n| Medium    | 500-10k | `1 year ago`        | 20           |\n| Large     | >10k    | `6 months ago`      | 30           |\n\nPrint the Repo Vitals line immediately:\n\n```\nRepo Vitals: Age: [FIRST_COMMIT to LATEST_COMMIT] | Commits: [COMMITS] | Branches: [BRANCHES] | Analysis window: [WINDOW or \"all time\"]\n```\n\n## Phase 2: Parallel Analysis\n\nRun all 7 commands in parallel (they are independent). Substitute `WINDOW` and `N` from Phase 1. For small repos, omit `--since` flags entirely.\n\n### 2a. Code Hotspots\n\nMost-changed files in the analysis window:\n\n```sh\ngit log --format=format: --name-only --since=\"WINDOW\" | sort | uniq -c | sort -nr | head -N\n```\n\n### 2b. Bus Factor\n\nAll-time contributor ranking by commit count:\n\n```sh\ngit shortlog -sn --no-merges\n```\n\n### 2c. Bug Magnets\n\nFiles most associated with bug-fix commits:\n\n```sh\ngit log -i -E --grep=\"fix|bug|broken\" --name-only --format='' --since=\"WINDOW\" | sort | uniq -c | sort -nr | head -N\n```\n\n### 2d. Team Momentum\n\nCommit frequency by month (all time):\n\n```sh\ngit log --format='%ad' --date=format:'%Y-%m' | sort | uniq -c\n```\n\n### 2e. Firefighting Frequency\n\nEmergency\u002Frevert commits in the analysis window:\n\n```sh\ngit log --oneline --since=\"WINDOW\" | grep -iE 'revert|hotfix|emergency|rollback'\n```\n\n### 2f. Recently Added Files\n\nNew files added in the analysis window:\n\n```sh\ngit log --diff-filter=A --since=\"WINDOW\" --name-only --format='' | sort | uniq -c | sort -nr | head -N\n```\n\n### 2g. Active vs Total Contributors\n\nCount of contributors active in the last 3 months (fixed window — measures \"who's here now\"):\n\n```sh\ngit shortlog -sn --no-merges --since=\"3 months ago\" | wc -l\n```\n\nCompare this count against the total from 2b.\n\n## Cross-Referencing\n\nAfter collecting all Phase 2 results, perform these cross-references before presenting the report:\n\n1. **High-Risk Files**: Intersect code hotspots (2a) with bug magnets (2c). Files appearing in both lists are highest-risk.\n2. **Risk Ownership**: For each high-risk file, run `git shortlog -sn -- \u003Cfile>` to identify the primary owner.\n3. **Bus Factor Risk**: If active contributors (2g) are less than 30% of total contributors (2b), flag this as a bus factor concern.\n4. **Momentum Trend**: Analyze the monthly commit counts (2d):\n   - Compare the average of the last 3 months to the average of the 3 months before that.\n   - Rising: last 3 months average > prior 3 months average by 20%+\n   - Declining: last 3 months average \u003C prior 3 months average by 20%+\n   - Erratic: month-over-month variance exceeds 50%\n   - Stable: otherwise\n\n## Report Template\n\nPresent the report in the terminal using this structure:\n\n```\n═══ Codebase Recon Report ═══\n\nRepo Vitals\n  Age: [first commit] to [latest commit] | Commits: N | Branches: N | Analysis window: WINDOW\n\n1. Code Hotspots (most-changed files)\n   [ranked list: count  filepath]\n\n2. Bug Magnets (files with fix\u002Fbug\u002Fbroken commits)\n   [ranked list: count  filepath]\n\n3. High-Risk Files (appear in BOTH hotspots AND bug magnets)\n   [list with: filepath — hotspot rank #X, bug magnet rank #Y, primary owner: NAME]\n   If none overlap, state: \"No files appear in both lists — good sign.\"\n\n4. Bus Factor\n   [top 10 contributors: count  name]\n   Active (last 3 months): X of Y total contributors\n   [If active \u003C 30% of total: \"Warning: low active contributor ratio — knowledge concentration risk\"]\n\n5. Team Momentum\n   [monthly commit counts, most recent 12 months or all if fewer]\n   Trend: [rising \u002F stable \u002F declining \u002F erratic]\n\n6. Firefighting Frequency\n   [list of revert\u002Fhotfix\u002Femergency commits, or \"None found\"]\n   Rate: N emergency commits out of M total in window (X%)\n\n7. Recently Added Files\n   [ranked list: count  filepath]\n\n8. Recommendations\n   - Start reading: [top 3 high-risk files, or top 3 hotspots if no high-risk files]\n   - Talk to: [primary owner of the #1 high-risk or hotspot file]\n   - Watch out: [any trend warnings — declining momentum, low bus factor, high firefighting rate]\n```\n\nAfter printing the report, ask:\n\n> \"Want me to save this report to a markdown file? (e.g., `docs\u002Fcodebase-recon-report.md`)\"\n\nIf yes, write the same content as a markdown file. Do not commit — let the user decide.\n","# Codebase Recon\n\nAnalyze git history to understand a codebase before reading any code. Reveals project health, risk areas, team structure, and development momentum.\n\nInspired by [\"The Git Commands I Run Before Reading Any Code\"](https:\u002F\u002Fpiechowski.io\u002Fpost\u002Fgit-commands-before-reading-code\u002F) by [Ally Piechowski](https:\u002F\u002Fgithub.com\u002Fgrepsedawk).\n\n## Phase 1: Probe\n\nBefore running analysis, determine repo scale to calibrate time windows and result counts.\n\nRun this single shell command to collect repo vitals:\n\n```sh\necho \"COMMITS=$(git rev-list --count HEAD)\" && \\\necho \"FIRST_COMMIT=$(git log --reverse --format='%ad' --date=short | head -1)\" && \\\necho \"LATEST_COMMIT=$(git log --format='%ad' --date=short | head -1)\" && \\\necho \"BRANCHES=$(git branch -a | wc -l | tr -d ' ')\"\n```\n\nUse the commit count to set parameters for Phase 2:\n\n| Repo Size | Commits | `WINDOW` (--since) | `N` (--head) |\n|-----------|---------|---------------------|--------------|\n| Small     | \u003C500    | (omit --since)      | 10           |\n| Medium    | 500-10k | `1 year ago`        | 20           |\n| Large     | >10k    | `6 months ago`      | 30           |\n\nPrint the Repo Vitals line immediately:\n\n```\nRepo Vitals: Age: [FIRST_COMMIT to LATEST_COMMIT] | Commits: [COMMITS] | Branches: [BRANCHES] | Analysis window: [WINDOW or \"all time\"]\n```\n\n## Phase 2: Parallel Analysis\n\nRun all 7 commands in parallel (they are independent). Substitute `WINDOW` and `N` from Phase 1. For small repos, omit `--since` flags entirely.\n\n### 2a. Code Hotspots\n\nMost-changed files in the analysis window:\n\n```sh\ngit log --format=format: --name-only --since=\"WINDOW\" | sort | uniq -c | sort -nr | head -N\n```\n\n### 2b. Bus Factor\n\nAll-time contributor ranking by commit count:\n\n```sh\ngit shortlog -sn --no-merges\n```\n\n### 2c. Bug Magnets\n\nFiles most associated with bug-fix commits:\n\n```sh\ngit log -i -E --grep=\"fix|bug|broken\" --name-only --format='' --since=\"WINDOW\" | sort | uniq -c | sort -nr | head -N\n```\n\n### 2d. Team Momentum\n\nCommit frequency by month (all time):\n\n```sh\ngit log --format='%ad' --date=format:'%Y-%m' | sort | uniq -c\n```\n\n### 2e. Firefighting Frequency\n\nEmergency\u002Frevert commits in the analysis window:\n\n```sh\ngit log --oneline --since=\"WINDOW\" | grep -iE 'revert|hotfix|emergency|rollback'\n```\n\n### 2f. Recently Added Files\n\nNew files added in the analysis window:\n\n```sh\ngit log --diff-filter=A --since=\"WINDOW\" --name-only --format='' | sort | uniq -c | sort -nr | head -N\n```\n\n### 2g. Active vs Total Contributors\n\nCount of contributors active in the last 3 months (fixed window — measures \"who's here now\"):\n\n```sh\ngit shortlog -sn --no-merges --since=\"3 months ago\" | wc -l\n```\n\nCompare this count against the total from 2b.\n\n## Cross-Referencing\n\nAfter collecting all Phase 2 results, perform these cross-references before presenting the report:\n\n1. **High-Risk Files**: Intersect code hotspots (2a) with bug magnets (2c). Files appearing in both lists are highest-risk.\n2. **Risk Ownership**: For each high-risk file, run `git shortlog -sn -- \u003Cfile>` to identify the primary owner.\n3. **Bus Factor Risk**: If active contributors (2g) are less than 30% of total contributors (2b), flag this as a bus factor concern.\n4. **Momentum Trend**: Analyze the monthly commit counts (2d):\n   - Compare the average of the last 3 months to the average of the 3 months before that.\n   - Rising: last 3 months average > prior 3 months average by 20%+\n   - Declining: last 3 months average \u003C prior 3 months average by 20%+\n   - Erratic: month-over-month variance exceeds 50%\n   - Stable: otherwise\n\n## Report Template\n\nPresent the report in the terminal using this structure:\n\n```\n═══ Codebase Recon Report ═══\n\nRepo Vitals\n  Age: [first commit] to [latest commit] | Commits: N | Branches: N | Analysis window: WINDOW\n\n1. Code Hotspots (most-changed files)\n   [ranked list: count  filepath]\n\n2. Bug Magnets (files with fix\u002Fbug\u002Fbroken commits)\n   [ranked list: count  filepath]\n\n3. High-Risk Files (appear in BOTH hotspots AND bug magnets)\n   [list with: filepath — hotspot rank #X, bug magnet rank #Y, primary owner: NAME]\n   If none overlap, state: \"No files appear in both lists — good sign.\"\n\n4. Bus Factor\n   [top 10 contributors: count  name]\n   Active (last 3 months): X of Y total contributors\n   [If active \u003C 30% of total: \"Warning: low active contributor ratio — knowledge concentration risk\"]\n\n5. Team Momentum\n   [monthly commit counts, most recent 12 months or all if fewer]\n   Trend: [rising \u002F stable \u002F declining \u002F erratic]\n\n6. Firefighting Frequency\n   [list of revert\u002Fhotfix\u002Femergency commits, or \"None found\"]\n   Rate: N emergency commits out of M total in window (X%)\n\n7. Recently Added Files\n   [ranked list: count  filepath]\n\n8. Recommendations\n   - Start reading: [top 3 high-risk files, or top 3 hotspots if no high-risk files]\n   - Talk to: [primary owner of the #1 high-risk or hotspot file]\n   - Watch out: [any trend warnings — declining momentum, low bus factor, high firefighting rate]\n```\n\nAfter printing the report, ask:\n\n> \"Want me to save this report to a markdown file? (e.g., `docs\u002Fcodebase-recon-report.md`)\"\n\nIf yes, write the same content as a markdown file. Do not commit — let the user decide.\n",{"name":5,"metadata":24,"description":28,"compatibility":29},{"author":25,"version":26,"inspired-by":27},"yujiachen-y","1.0","https:\u002F\u002Fpiechowski.io\u002Fpost\u002Fgit-commands-before-reading-code\u002F","Use when entering an unfamiliar codebase, onboarding to a new project, or wanting to assess codebase health before reading code — analyzes git history to reveal hotspots, risk areas, team structure, and development momentum\n","Requires git. Works in any terminal-based coding agent.","master","27569b7821134286c3e1035e821846f3a486605b","skills\u002Fcodebase-recon\u002Fcodex","https:\u002F\u002Fgithub.com\u002Fshabanakhtar\u002Fai-agent-skills","https:\u002F\u002Fgithub.com\u002Fshabanakhtar","Working on da stuff\r\n","2026-08-04 00:48:26",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add shabanakhtar\u002Fai-agent-skills --skill codebase-recon",{"tool":43,"command":44},"bunx","bunx skills add shabanakhtar\u002Fai-agent-skills --skill codebase-recon",{"tool":46,"command":47},"pnpm","pnpm dlx skills add shabanakhtar\u002Fai-agent-skills --skill codebase-recon","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fshabanakhtar\u002Fai-agent-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fcodebase-recon\u002Fcodex\u002FSKILL.md",true,[],[52,58,65,72,78,85],{"skillNo":53,"name":54,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M78ANE49B4G9H6CP3NG6C345","codex","https:\u002F\u002Fgithub.com\u002Fshabanakhtar\u002Fai-agent-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fproject-kickoff\u002Fcodex\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M78ANAHNMQ1RG7MX07JKWEXT","project-kickoff","Use immediately when starting a new software project, setting up a repo, kicking off a project, creating a fresh codebase, or preparing Claude Code and Codex to collaborate on the same project. This skill is intentionally proactive: trigger on requests like \"new project\", \"start a project\", \"set up a repo\", \"project kickoff\", \"bootstrap this app\", or similar phrasing even if the user does not name this skill.","https:\u002F\u002Fgithub.com\u002Fshabanakhtar\u002Fai-agent-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fproject-kickoff\u002Fclaude\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M78AN6NYTK7J2FYQ931E9H4H","my-voice","Write or rewrite text in Shaban's natural voice. Use only when he manually invokes `$my-voice`, explicitly says \"write like me\", or explicitly says \"in my voice\". Apply to any writing format, including LinkedIn posts, captions, messages, and project copy. Do not apply to ordinary writing requests without one of those explicit triggers.","https:\u002F\u002Fgithub.com\u002Fshabanakhtar\u002Fai-agent-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fmy-voice\u002Fcodex\u002FSKILL.md",[],[],{"skillNo":73,"name":67,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M78AN3Z1MNF6T5QMPHAQ6Q0C","Write or rewrite text in Shaban's natural voice. Use only when he manually invokes `\u002Fmy-voice`, explicitly says \"write like me\", or explicitly says \"in my voice\". Apply to any writing format, including LinkedIn posts, captions, messages, and project copy. Do not apply to ordinary writing requests without one of those explicit triggers.","https:\u002F\u002Fgithub.com\u002Fshabanakhtar\u002Fai-agent-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fmy-voice\u002Fclaude\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M78AMVQ579CRH0Y67FQPF9S6","humanizer","Remove signs of AI-generated writing from text. Use when editing or reviewing\ntext to make it sound more natural and human-written. Based on Wikipedia's\ncomprehensive \"Signs of AI writing\" guide. Detects and fixes patterns including:\ninflated symbolism, promotional language, superficial -ing analyses, vague\nattributions, em dash overuse, rule of three, AI vocabulary words, passive\nvoice, negative parallelisms, and filler phrases.","https:\u002F\u002Fgithub.com\u002Fshabanakhtar\u002Fai-agent-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fhumanizer\u002Fcodex\u002FSKILL.md",[],[],{"skillNo":86,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M78AMKVVR3FBBAD42TGDMXFX","https:\u002F\u002Fgithub.com\u002Fshabanakhtar\u002Fai-agent-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fhumanizer\u002Fclaude\u002FSKILL.md",[],[]]