{"id":47600666,"url":"https://github.com/chriscox/agent-skills","last_synced_at":"2026-04-01T18:50:13.597Z","repository":{"id":342914507,"uuid":"1175547432","full_name":"chriscox/agent-skills","owner":"chriscox","description":"Reusable skills for AI coding agents — Claude Code, Codex, Gemini CLI, and OpenClaw","archived":false,"fork":false,"pushed_at":"2026-03-07T23:57:53.000Z","size":22,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-08T04:50:50.034Z","etag":null,"topics":["ai-coding-agent","ai-skills","claude-code","codex","developer-tools","gemini-cli","openclaw"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/chriscox.png","metadata":{"files":{"readme":"README.md","changelog":null,"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-07T21:23:51.000Z","updated_at":"2026-03-08T00:26:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chriscox/agent-skills","commit_stats":null,"previous_names":["chriscox/agent-skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/chriscox/agent-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chriscox%2Fagent-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chriscox%2Fagent-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chriscox%2Fagent-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chriscox%2Fagent-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chriscox","download_url":"https://codeload.github.com/chriscox/agent-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chriscox%2Fagent-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290960,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"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":["ai-coding-agent","ai-skills","claude-code","codex","developer-tools","gemini-cli","openclaw"],"created_at":"2026-04-01T18:50:13.020Z","updated_at":"2026-04-01T18:50:13.590Z","avatar_url":"https://github.com/chriscox.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Agent Skills\n\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Skills](https://img.shields.io/badge/skills-2-brightgreen)](#skills)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-compatible-blueviolet?logo=anthropic)](https://docs.anthropic.com/en/docs/claude-code)\n[![Codex](https://img.shields.io/badge/Codex-compatible-brightgreen?logo=openai)](https://github.com/openai/codex)\n[![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-compatible-4285F4?logo=google)](https://github.com/google-gemini/gemini-cli)\n[![OpenClaw](https://img.shields.io/badge/OpenClaw-compatible-orange)](https://github.com/openclaw/openclaw)\n\nReusable skills for AI coding agents — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [Gemini CLI](https://github.com/google-gemini/gemini-cli), and [OpenClaw](https://github.com/openclaw/openclaw).\n\nSkills are modular instruction sets that teach your agent how your team works — your\ntemplates, your conventions, your docs structure — so it gets it right the first time.\n\n## Skills\n\n| Skill | What it does |\n|-------|-------------|\n| [project-planner](#project-planner) | Turns ideas, bugs, and feature requests into structured GitHub issues and proposals |\n| [docs-sync](#docs-sync) | Keeps docs in sync with code changes — updates, audits, and site navigation |\n\n---\n\n\u003ca id=\"project-planner\"\u003e\u003c/a\u003e\n### project-planner\n\n**Turn vague ideas into structured, actionable project artifacts.**\n\nYou say \"I have an idea for dark mode\" or \"search is broken on special characters\" and\nthe skill figures out the right format, creates it in the right place, and follows your\nproject's conventions.\n\n| You say... | Skill creates... |\n|---|---|\n| \"I have an idea for X\" / \"Let's plan Y\" | **Proposal** — design doc with phases, acceptance criteria, a tracking issue with native GitHub sub-issues per phase |\n| \"Add a button that does X\" | **Feature issue** — focused GitHub issue with acceptance criteria |\n| \"X is broken when Y\" | **Bug report** — GitHub issue with repro steps, expected vs actual, relevant code |\n\n**Repo-aware** — discovers your `.github/ISSUE_TEMPLATE/` files, proposal templates,\n`CLAUDE.md`/`CONTRIBUTING.md` conventions, and `.project-planner.yml` config. Works\nout of the box with sensible defaults.\n\n**Prerequisites:** Git, [GitHub CLI (`gh`)](https://cli.github.com/) authenticated via `gh auth login`\n\n\u003cdetails\u003e\n\u003csummary\u003eOptional per-repo config\u003c/summary\u003e\n\nDrop a `.project-planner.yml` at your repo root:\n\n```yaml\nproject: MyProject                      # project name (used in issue titles)\n\nproposals:\n  dir: docs/proposals                   # where proposal docs live\n  template: docs/proposals/TEMPLATE.md  # proposal template to follow\n\nissues:\n  labels:\n    feature: enhancement                # label for feature issues\n    bug: bug                            # label for bug issues\n```\n\nAll fields are optional — anything you don't set gets auto-discovered or falls back to defaults.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eStarter templates\u003c/summary\u003e\n\nIf you're setting up a new repo and want issue templates and a config file to start from:\n\n```bash\ncd /path/to/your-project\n/path/to/agent-skills/install.sh templates project-planner\n```\n\nCreates starter files you can customize (`.project-planner.yml`, issue templates,\nproposal template). Won't overwrite existing files — use `--force` to replace them.\n\n\u003c/details\u003e\n\n---\n\n\u003ca id=\"docs-sync\"\u003e\u003c/a\u003e\n### docs-sync\n\n**Your docs are always out of date. This skill fixes that.**\n\nAfter a PR merges or code changes, it figures out which docs need updating and drafts\nthe changes.\n\n**Three modes:**\n\n- **Content sync** — reads a PR diff, identifies affected docs, drafts targeted updates\n- **Site management** — maintains mkdocs/docusaurus/vitepress navigation and index files\n- **Docs audit** — reports which docs are stale and what needs updating\n\n| Code change | Docs updated |\n|---|---|\n| New UI component | Features list, architecture doc |\n| Changed data model | Architecture doc |\n| New keyboard shortcut | Features list |\n| New API endpoint | API reference, possibly README |\n| Changed build command | Contributing / conventions doc |\n\nThe skill maps each doc to a role (features, architecture, conventions, changelog, readme,\napi) — auto-detected from filenames, or configured via `.docs-sync.yml`.\n\n**Prerequisites:** Git, [GitHub CLI (`gh`)](https://cli.github.com/)\n\n\u003cdetails\u003e\n\u003csummary\u003eOptional per-repo config\u003c/summary\u003e\n\nDrop a `.docs-sync.yml` at your repo root:\n\n```yaml\ndocs:\n  - path: docs/features.md\n    role: features\n\n  - path: docs/architecture.md\n    role: architecture\n\n  - path: CHANGELOG.md\n    role: changelog\n    format: keep-a-changelog\n\nsite:\n  engine: mkdocs\n  config: mkdocs.yml\n  auto_nav: true\n```\n\n\u003c/details\u003e\n\n---\n\n## Installation\n\nThese skills work with any supported platform — install on one or all of them.\n\nEach platform has a native install method. There's also a universal install script\nthat works across all of them.\n\n### Native install\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cstrong\u003eClaude Code\u003c/strong\u003e\u003c/summary\u003e\n\nAdd the marketplace, then install one or both skills:\n```bash\n/plugin marketplace add chriscox/agent-skills\n/plugin install project-planner@chriscox-skills\n/plugin install docs-sync@chriscox-skills\n```\n\nEach skill is an independent plugin — install one, both, or neither.\nSkills auto-activate based on context.\n\nOr load from a local clone:\n```bash\ngit clone https://github.com/chriscox/agent-skills.git\nclaude --plugin-dir ./agent-skills/plugins/project-planner\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCodex\u003c/strong\u003e\u003c/summary\u003e\n\nIn any Codex session:\n\n\u003e Install skill from chriscox/agent-skills, path skills/\u0026lt;skill-name\u0026gt;\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eGemini CLI\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# install individual skills\ngemini skills install https://github.com/chriscox/agent-skills.git --path skills/\u003cskill-name\u003e\n\n# or link the entire repo (discovers all skills automatically)\ngit clone https://github.com/chriscox/agent-skills.git\ngemini skills link ./agent-skills/skills\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eOpenClaw\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nclawhub install project-planner                 # install individual skills by name\nclawhub install docs-sync\n```\n\n\u003c/details\u003e\n\n### Install script\n\nA universal install script works across all platforms:\n\n```bash\ngit clone https://github.com/chriscox/agent-skills.git\ncd agent-skills\n./install.sh list                               # see available skills\n./install.sh skill \u003cskill-name\u003e --codex         # or --gemini, --openclaw, --all\n```\n\n## Why skills instead of CLAUDE.md?\n\nYou can absolutely write planning and docs-sync instructions directly in your\n`CLAUDE.md` (or `AGENTS.md`, `GEMINI.md`, etc.). It works. But skills solve a\ndifferent problem — here's how they compare:\n\n### What CLAUDE.md is great at\n\nYour project file (`CLAUDE.md`) is the right place for things specific to *your* repo:\ncoding conventions, architecture decisions, build commands, tech stack choices. It's\nvisible, simple, and has zero dependencies.\n\n### Where skills add value\n\nSkills handle *workflows* — things that work the same way across every repo you touch.\n\n**Install once, use everywhere.** A skill installed at user scope works in every repo\nautomatically. Writing \"how to create a good proposal doc with phased issues\" in\n`CLAUDE.md` means copying those instructions into every repo — and updating all of\nthem when you improve the workflow.\n\n**Cross-platform.** One skill definition works in Claude Code, Codex, Gemini CLI, and\nOpenClaw. With project files, you'd maintain the same instructions in `CLAUDE.md` *and*\n`AGENTS.md` *and* `GEMINI.md` — per repo.\n\n**Small config replaces long instructions.** A 10-line `.project-planner.yml` replaces\npages of prompt engineering. The skill already knows how to triage ideas, structure\nproposals, and file issues. You just tell it where your templates live.\n\n**Centrally maintained.** When a skill improves — better edge-case handling, new\ncapabilities — you run `update` and get the improvements everywhere. With `CLAUDE.md`,\nyou maintain the instructions yourself and they drift over time.\n\n**Repo-aware auto-discovery.** Skills discover your repo structure (issue templates,\ndocs layout, site config) automatically. In `CLAUDE.md` you'd spell out every path\nand template explicitly.\n\n### The short version\n\n| | CLAUDE.md | Skills |\n|---|---|---|\n| Best for | Project-specific conventions | Cross-project workflows |\n| Scope | One repo | Every repo you touch |\n| Platforms | One agent | All supported agents |\n| Maintenance | Manual, per repo | Central, update once |\n| Config | Free-form instructions | Small YAML + auto-discovery |\n\nThey're complementary. `CLAUDE.md` tells the agent about *your project*. Skills teach\nit reusable workflows that work the same way everywhere.\n\n---\n\n## Use cases\n\n**Solo dev with many repos.** You work on a main project, a few side projects, some\nopen-source contributions. Install once at user scope — every repo gets consistent\nplanning and docs workflows without any per-repo setup.\n\n**Team standardization.** Your team files issues in different formats. Some PRs update\ndocs, most don't. Everyone installs the same marketplace and gets the same issue\nstructure, the same docs-sync behavior, the same proposal format — without\nmaintaining a shared wiki page of \"how to file a good issue.\"\n\n**New repo bootstrap.** Starting a new project? `install.sh templates project-planner`\nscaffolds issue templates, a proposal template, and config in seconds.\nNo copy-pasting from another repo.\n\n**Multi-agent workflows.** Running an orchestrator (like OpenClaw) that spawns coding\nagents? Both layers get the same skills — the orchestrator uses project-planner to\ncreate issues, the coding agent uses docs-sync to update docs after implementing them.\n\n**Cross-platform teams.** Some teammates prefer Claude Code, others use Codex or\nGemini CLI. Skills work identically across all of them — same behavior, same output\nformat, no per-tool instructions.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchriscox%2Fagent-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchriscox%2Fagent-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchriscox%2Fagent-skills/lists"}