{"id":51202220,"url":"https://github.com/patdhlk/skills","last_synced_at":"2026-06-28T01:03:27.947Z","repository":{"id":362529387,"uuid":"1259406943","full_name":"patdhlk/skills","owner":"patdhlk","description":"Agent workflow skills with sphinx-needs-backed issues, requirements, and ADRs — drop-in replacement for mattpocock/skills","archived":false,"fork":false,"pushed_at":"2026-06-14T20:55:37.000Z","size":375,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-14T22:05:48.537Z","etag":null,"topics":["agent-skills","claude-code","requirements-management","sphinx-needs"],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/patdhlk.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-06-04T13:29:51.000Z","updated_at":"2026-06-14T20:55:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/patdhlk/skills","commit_stats":null,"previous_names":["patdhlk/skills"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/patdhlk/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdhlk%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdhlk%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdhlk%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdhlk%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/patdhlk","download_url":"https://codeload.github.com/patdhlk/skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdhlk%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34873664,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agent-skills","claude-code","requirements-management","sphinx-needs"],"created_at":"2026-06-28T01:03:27.341Z","updated_at":"2026-06-28T01:03:27.942Z","avatar_url":"https://github.com/patdhlk.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# patdhlk-skills\n\nAgent workflow skills for Claude Code, with **sphinx-needs** as the backbone:\nissues, requirements, features, architecture decisions, and glossary terms are\ntraceable `sphinx-needs` directives in RST — never markdown. Issues can\nalternatively live on GitHub; everything else always lives in the spec.\n\nA drop-in replacement for [mattpocock/skills](https://github.com/mattpocock/skills)\n(whose concepts these skills port — thanks, Matt). **Do not install both** —\nthe skill names collide on purpose.\n\n## Install\n\n```bash\nnpx skills@latest add patdhlk/skills\n```\n\nor via the Claude Code plugin marketplace (`patdhlk-skills`).\n\n## The model\n\n- A consumer repo declares its setup in `ubproject.toml`:\n\n  ```toml\n  [tool.patdhlk-skills]\n  issue_backend = \"sphinx-needs\"   # or \"github\"\n  spec_dir = \"spec\"\n  builder = \"ubc\"                  # or \"sphinx-build\"\n\n  [tool.patdhlk-skills.roles]\n  issue = \"issue\"\n  requirement = \"req\"\n  decision = \"arch-decision\"\n  # ... maps abstract roles to YOUR directive names\n  ```\n\n- Skills **read** the corpus by building `needs.json` (`pds build`, which\n  runs the configured builder — ubc preferred, sphinx-build fallback) and\n  querying it with `jq`.\n- Skills **write** by editing RST and finishing with the strict gate\n  (`pds check`; raw `sphinx-build -W` when `pds` is missing) — schema\n  violations, broken links, and duplicate IDs fail immediately.\n- Run `/setup-patdhlk-skills` once per repo: it adapts to your existing\n  `ubproject.toml` (never imposes a catalog), persists the role map, and can\n  scaffold a spec skeleton (via [uv](https://docs.astral.sh/uv/)), the\n  [sphinx-needs-starter](https://github.com/patdhlk/sphinx-needs-starter)\n  devcontainer, and a strict-build CI workflow.\n\n## Skills (v1)\n\n| Group | Skills |\n|---|---|\n| Issue flow | `/to-prd`, `/to-issues`, `/triage`, `/qa` |\n| Docs \u0026 decisions | `/grill-me`, `/grill-with-docs`, `/decide` |\n| Dev loop | `/tdd`, `/diagnose`, `/review`, `/prototype` |\n| Setup | `/setup-patdhlk-skills` |\n\nImplementation status is tracked — of course — as `.. issue::` directives in\n[`spec/issues/`](spec/issues/index.rst).\n\n## This repo dogfoods itself\n\nThe design lives in [`spec/`](spec/): the founding decisions as\n`arch-decision` directives, the backlog as `issue` directives, the domain\nlanguage as `term` directives. See `spec/architecture/index.rst` for the\nADRs that explain everything above.\n\n```bash\nuv sync          # set up the toolchain\nmake html        # build the spec\nmake strict      # the strict gate CI runs (= pds check)\nmake needs       # build needs.json (= pds build)\nmake serve       # live preview on :8000\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatdhlk%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatdhlk%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatdhlk%2Fskills/lists"}