{"id":46662538,"url":"https://github.com/devlikebear/ai-skills","last_synced_at":"2026-04-06T15:02:49.189Z","repository":{"id":342941018,"uuid":"1175693438","full_name":"devlikebear/ai-skills","owner":"devlikebear","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-06T14:11:29.000Z","size":206,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T14:28:33.676Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devlikebear.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-08T03:20:30.000Z","updated_at":"2026-04-06T14:11:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/devlikebear/ai-skills","commit_stats":null,"previous_names":["devlikebear/ai-skills"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/devlikebear/ai-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devlikebear%2Fai-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devlikebear%2Fai-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devlikebear%2Fai-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devlikebear%2Fai-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devlikebear","download_url":"https://codeload.github.com/devlikebear/ai-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devlikebear%2Fai-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31477013,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T14:34:32.243Z","status":"ssl_error","status_checked_at":"2026-04-06T14:34:31.723Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-08T13:06:17.532Z","updated_at":"2026-04-06T15:02:49.183Z","avatar_url":"https://github.com/devlikebear.png","language":"Python","readme":"# AI Skills Repository\n\nPublic repository for reusable AI-agent skills, supporting both Codex and Claude Code.\n\nCurrent release: `0.10.6`\n\n## Overview\n\n- Supports both Codex runtime skills and a Claude Code plugin marketplace.\n- Codex skills use a flat runtime layout: one `SKILL.md`, one `agents/openai.yaml`, and optional `shared/`.\n- Claude Code skills are distributed through the `code-workflow` plugin with bilingual `SKILL.md` files and shared `references/`.\n- `source-analyzer` produces resumable `.analysis/` outputs and now ships a wiki publisher alongside its checkpoint manager.\n- `source-analyzer` also ships a local search MCP server for querying analysis outputs and checkpoints.\n- A local authoring wrapper lives at `.codex/skills/skill-generator`.\n- Public Codex skill roots:\n  - `codex/skills/source-analyzer`\n  - `codex/skills/implement`\n  - `codex/skills/plan-for-codex`\n  - `codex/skills/refactor`\n  - `codex/skills/review`\n  - `codex/skills/github-flow`\n\n## Repository Layout\n\n```text\ncodex/\n  skills/\n    source-analyzer/\n      SKILL.md\n      agents/\n      shared/\n    implement/\n      SKILL.md\n      agents/\n      shared/\n    plan-for-codex/\n      SKILL.md\n      agents/\n      shared/\n    refactor/\n      SKILL.md\n      agents/\n      shared/\n    review/\n      SKILL.md\n      agents/\n      shared/\n    github-flow/\n      SKILL.md\n      agents/\n      shared/\nclaude-code/\n  plugin/\n    .claude-plugin/\n      plugin.json\n    .mcp.json\n    skills/\n      source-analyzer/\n      implement/\n      plan/\n      refactor/\n      review/\n      github-flow/\n    references/\n    scripts/\n.agents/\n  plugins/\n    marketplace.json\n.claude-plugin/\n  marketplace.json\nplugins/\n  source-analyzer-tools/\n    .codex-plugin/\n      plugin.json\n    .mcp.json\n    servers/\nservers/\n  source-analyzer-mcp/\n.codex/\n  skills/\n    skill-generator/\n      SKILL.md\n      agents/\nscripts/\n  install_codex_skill.sh\n  sync_source_analyzer_mcp.sh\n  publish_wiki.sh\ntests/\n```\n\n`codex/skills/\u003cskill-name\u003e` stores the Codex source layout with flat runtime files only.\n`claude-code/plugin/` is the Claude Code plugin distribution with shared references and shared scripts.\n\n## Included Skills\n\n### `source-analyzer`\n\n- Analyzes an existing codebase without modifying source files.\n- Produces resumable outputs under `.analysis/sessions/` and published outputs under `.analysis/outputs/`.\n- Supports `analyze`, `refactor-guide`, and `overhaul` modes.\n- Ships `checkpoint_manager.py` and `publish_wiki.sh` in both Codex and Claude Code distributions.\n- Can build a local search cache under `.analysis/cache/source-analyzer-search/`.\n- Ships a local MCP server that exposes search, module lookup, dependency tracing, and checkpoint/session queries.\n\n### `implement`\n\n- Executes an approved work order directly.\n- Keeps the scope small, explicit, and verification-driven.\n\n### `plan-for-codex`\n\n- Splits a request into executable work orders for Codex.\n- Keeps tasks bounded, verifiable, and ready for `/implement`.\n\n### `refactor`\n\n- Performs safe, behavior-preserving refactoring.\n- Uses shared checklists and refactoring patterns.\n\n### `review`\n\n- Performs diff-based review focused on regressions, security issues, and missing tests.\n- Produces a fix work order when changes are required.\n\n### `github-flow`\n\n- Guides through the full GitHub Flow lifecycle: branch → develop → PR → merge → release.\n- Phase 2 integrates `plan` → `implement` → `review` as an inner loop before each commit.\n- Available for both Codex (`/github-flow`) and Claude Code (`/code-workflow:github-flow`).\n\n### `skill-generator`\n\n- Lives under `.codex/skills/skill-generator`.\n- Wraps the upstream `skill-creator` workflow for this repository.\n- Enforces the flat `SKILL.md` + `agents/openai.yaml` + optional `shared/` convention used by public Codex skills.\n\n## Install for Codex\n\nClone this repository, then install one or more skills into your local Codex home.\n\n```bash\nscripts/install_codex_skill.sh --list\nscripts/install_codex_skill.sh source-analyzer\nscripts/install_codex_skill.sh source-analyzer --with-mcp\nscripts/install_codex_skill.sh implement\nscripts/install_codex_skill.sh --all\n```\n\nBy default the installer copies skills into `${CODEX_HOME:-$HOME/.codex}/skills`.\nEach skill is a single `SKILL.md` that responds in the user's language automatically.\nFor `source-analyzer`, `--with-mcp` also registers `source-analyzer-search` via `codex mcp add ...`.\n\n### Codex quickstart for `source-analyzer-search`\n\n```bash\nscripts/install_codex_skill.sh source-analyzer --with-mcp\ncodex mcp list\npython3 ~/.codex/skills/source-analyzer/shared/scripts/checkpoint_manager.py generate-search-index\n```\n\nAfter registration, Codex should list `source-analyzer-search` in `codex mcp list`.\nOnce `.analysis/outputs/` and `.analysis/cache/source-analyzer-search/` exist, the agent can call:\n\n- `analysis.search` for natural-language retrieval across overview, architecture, module docs, issues, and checkpoints\n- `analysis.get_module` for a direct module doc or module-map lookup\n- `analysis.trace_dependencies` for dependency expansion from a file path\n\nThe repo also includes a Codex plugin bundle artifact:\n\n- `.agents/plugins/marketplace.json`\n- `plugins/source-analyzer-tools/`\n\nCanonical MCP sources live under `servers/source-analyzer-mcp/`.\nUse `scripts/sync_source_analyzer_mcp.sh` when bundle copies need to be refreshed.\n\n## Install via Plugin Marketplace (Claude Code)\n\nThis repository is also a Claude Code plugin marketplace. Add it directly and install the `code-workflow` plugin:\n\n```bash\n# Add this repo as a marketplace\n/plugin marketplace add devlikebear/ai-skills\n\n# Install the plugin\n/plugin install code-workflow@ai-skills\n```\n\nAfter installation the following skills are available:\n\n- `/code-workflow:plan`\n- `/code-workflow:implement`\n- `/code-workflow:review`\n- `/code-workflow:refactor`\n- `/code-workflow:source-analyzer`\n- `/code-workflow:github-flow`\n\nPlugin skills are bilingual and detect the user's language automatically.\nThe plugin now also bundles `source-analyzer-search` through `claude-code/plugin/.mcp.json`.\n\n### Claude Code quickstart for `source-analyzer-search`\n\n1. Run `/code-workflow:source-analyzer` and let it publish `.analysis/outputs/`.\n2. Run `python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/checkpoint_manager.py\" generate-search-index` inside the analyzed project.\n3. Ask Claude Code to use `analysis.search`, `analysis.get_module`, or `analysis.trace_dependencies` against that project.\n\n## Build Search Cache\n\n`source-analyzer` now auto-generates the search cache when outputs are published on `paused` or `completed` checkpoints.\nIf you already finished analysis earlier, you can still generate or rebuild the index manually:\n\n```bash\npython3 codex/skills/source-analyzer/shared/scripts/checkpoint_manager.py generate-search-index\n```\n\nIf the cache is missing, the MCP server can still fall back to direct scanning of `.analysis/outputs/`.\n\nExample retrieval prompts once the MCP server is available:\n\n- `Use analysis.search to find the auth token validation flow.`\n- `Use analysis.get_module for auth and summarize the responsibilities.`\n- `Use analysis.trace_dependencies for src/auth.py with depth 2.`\n\n## Publish Analysis to GitHub Wiki\n\nFor this repository itself, use the root helper:\n\n```bash\nscripts/publish_wiki.sh --session-id analyze-20260308-120027\nscripts/publish_wiki.sh --dry-run\n```\n\nWhen `source-analyzer` is installed as a runtime skill, the distributed wiki publishers live at:\n\n- `codex/skills/source-analyzer/shared/scripts/publish_wiki.sh`\n- `claude-code/plugin/scripts/publish_wiki.sh`\n\nThose distributed scripts support `--project-dir \u003cpath\u003e` so they can publish analysis outputs from another checked-out project.\n\n## Skill Root Convention\n\n### Codex skills\n\n```text\n\u003cskill-name\u003e/\n  SKILL.md\n  agents/\n    openai.yaml\n  shared/\n    scripts/\n    references/\n```\n\n### Claude Code plugin skills\n\n```text\n\u003cskill-name\u003e/\n  SKILL.md\n```\n\nShared references live in `claude-code/plugin/references/` and are referenced by all plugin skills.\n\nUse `.codex/skills/skill-generator` when you want to generate a new Codex skill that follows the repository convention.\n\n## Notes\n\n- Codex discovers runtime skills from `~/.codex/skills`.\n- Codex MCP servers can be registered directly with `codex mcp add ...`.\n- Claude Code installs skills via plugin marketplace.\n- `.analysis/outputs/` contains publishable, git-trackable analysis outputs.\n- `.analysis/cache/source-analyzer-search/` contains local search indexes for MCP retrieval.\n- Release history is tracked in `CHANGELOG.md`.\n- Licensing is provided in `LICENSE`.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevlikebear%2Fai-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevlikebear%2Fai-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevlikebear%2Fai-skills/lists"}