{"id":50910363,"url":"https://github.com/roerohan/skills","last_synced_at":"2026-06-16T09:32:50.832Z","repository":{"id":358228399,"uuid":"1238055994","full_name":"roerohan/skills","owner":"roerohan","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-16T09:56:48.000Z","size":445,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-16T11:47:52.613Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/roerohan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"roerohan","patreon":null,"open_collective":null,"ko_fi":"roerohan","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":"roerohan","buy_me_a_coffee":"roerohan","thanks_dev":null,"custom":null}},"created_at":"2026-05-13T19:13:45.000Z","updated_at":"2026-05-16T09:56:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/roerohan/skills","commit_stats":null,"previous_names":["roerohan/skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/roerohan/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roerohan%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roerohan%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roerohan%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roerohan%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roerohan","download_url":"https://codeload.github.com/roerohan/skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roerohan%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34400451,"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-16T02:00:06.860Z","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":[],"created_at":"2026-06-16T09:32:50.743Z","updated_at":"2026-06-16T09:32:50.823Z","avatar_url":"https://github.com/roerohan.png","language":"Shell","funding_links":["https://github.com/sponsors/roerohan","https://ko-fi.com/roerohan","https://polar.sh/roerohan","https://buymeacoffee.com/roerohan"],"categories":[],"sub_categories":[],"readme":"# Skills For Practical Agents\n\nReusable agent skills I use to make coding agents more useful, less vague, and less likely to sprint confidently into a wall.\n\nThese skills are small, composable workflows for OpenCode and other `SKILL.md`-compatible agents. They cover planning, frontend design, Cloudflare work, codebase exploration, repository walkthroughs, Jira automation, tmux-managed servers, and skill authoring.\n\nThe repo is intentionally boring: each skill lives in its own folder at the repository root, with a `SKILL.md` file and any supporting scripts or references next to it.\n\n## Quickstart\n\nPoint OpenCode at this repo by adding it to your `opencode.json`:\n\n```json\n{\n  \"skills\": {\n    \"paths\": [\"~/path/to/skills\"]\n  }\n}\n```\n\nOpenCode scans custom skill paths for `**/SKILL.md`, so top-level folders like `tmux/SKILL.md` and `spec-planner/SKILL.md` are picked up automatically.\n\nIf you need to refresh a runtime copy manually:\n\n```bash\ncp -R ~/path/to/skills/* ~/.config/opencode/skills/\n```\n\nDo not author new skills there. Author them in this repo, then sync or configure OpenCode to load this repo directly.\n\n## Why These Skills Exist\n\nAgents are powerful, but they fail in familiar ways:\n\n- They start building before understanding the problem.\n- They produce generic plans that sound good and survive zero contact with the codebase.\n- They run long-lived processes inline and turn the terminal into soup.\n- They miss project context, naming conventions, and architectural pressure points.\n- They need a repeatable way to use specialized references without bloating every prompt.\n\nThese skills make those failure modes explicit and give the agent better rails.\n\n## Skills\n\n### Planning And Product Thinking\n\n- **[grill-me](./grill-me/SKILL.md)** — Interview the user relentlessly about a plan or design until the decision tree is resolved.\n- **[spec-planner](./spec-planner/SKILL.md)** — Develop implementation-ready specs through skeptical questioning, discovery, drafting, and refinement.\n- **[repo-walkthrough](./repo-walkthrough/SKILL.md)** — Explain how a repository works at a calibrated level, from novice overview to detailed architecture tour.\n\n### Engineering Workflow\n\n- **[tmux](./tmux/SKILL.md)** — Manage dev servers, watchers, logs, and other long-running commands in tmux panes.\n- **[using-git-worktrees](./using-git-worktrees/SKILL.md)** — Create isolated git worktrees for feature work without trampling the current workspace.\n- **[diff-walkthrough](./diff-walkthrough/SKILL.md)** — Produce guided walkthroughs of diffs, PRs, MRs, commit ranges, or staged changes with configurable depth and output format.\n- **[improve-codebase-architecture](./improve-codebase-architecture/SKILL.md)** — Find refactoring opportunities that deepen modules and improve testability and agent navigability.\n- **[index-knowledge](./index-knowledge/SKILL.md)** — Generate hierarchical `AGENTS.md` knowledge files for a codebase.\n\n### Platform And Tooling\n\n- **[cloudflare](./cloudflare/SKILL.md)** — Work across Cloudflare Workers, Pages, KV, D1, R2, Durable Objects, Workers AI, Vectorize, networking, security, and IaC.\n- **[jira-tool](./jira-tool/SKILL.md)** — Create, update, transition, and manage Jira tickets through the bundled CLI workflow.\n- **[frontend-design](./frontend-design/SKILL.md)** — Apply React-oriented UI/UX guidance for component structure, layout, accessibility, and interaction design.\n\n### Agent And Skill Infrastructure\n\n- **[build-skill](./build-skill/SKILL.md)** — Create, review, and validate effective skills with the expected structure and progressive disclosure patterns.\n- **[install-skill](./install-skill/SKILL.md)** — Install agent skills from GitHub repositories using `gh`.\n- **[librarian](./librarian/SKILL.md)** — Research library internals, code patterns, and architecture across GitHub, npm, PyPI, and crates repositories.\n\n## Skill Structure\n\nEach skill should look like this:\n\n```text\nskill-name/\n  SKILL.md\n  references/\n  scripts/\n```\n\nOnly `SKILL.md` is required. Put large references and executable helpers next to the skill instead of bloating the main instructions.\n\nEvery `SKILL.md` should include frontmatter:\n\n```markdown\n---\nname: skill-name\ndescription: Use this when the agent should do a specific thing.\n---\n```\n\nSkill names should be lowercase kebab-case.\n\n## License\n\nMIT. Use these, change them, delete the spicy bits, make them yours.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froerohan%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froerohan%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froerohan%2Fskills/lists"}