{"id":51302400,"url":"https://github.com/stophydotdev/skills","last_synced_at":"2026-06-30T21:02:05.138Z","repository":{"id":363910279,"uuid":"1264397347","full_name":"stophydotdev/skills","owner":"stophydotdev","description":"Agent skills for working with YouTube through the Stophy CLI.","archived":false,"fork":false,"pushed_at":"2026-06-30T12:41:36.000Z","size":53,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-30T13:24:06.943Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stophydotdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-09T21:07:19.000Z","updated_at":"2026-06-30T12:41:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/stophydotdev/skills","commit_stats":null,"previous_names":["stophydotdev/skiils","stophydotdev/skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stophydotdev/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stophydotdev%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stophydotdev%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stophydotdev%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stophydotdev%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stophydotdev","download_url":"https://codeload.github.com/stophydotdev/skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stophydotdev%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34983171,"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-30T02:00:05.919Z","response_time":92,"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-30T21:02:03.735Z","updated_at":"2026-06-30T21:02:05.132Z","avatar_url":"https://github.com/stophydotdev.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stophy — YouTube context API for AI agents\n\n[![skills.sh](https://skills.sh/b/stophydotdev/skills)](https://skills.sh/stophydotdev/skills)\n\nStophy is a YouTube context API for AI agents. It returns clean, structured JSON for search, query suggestions, video details, transcripts, comments, replies, live chat, channels, and playlists. This repository is a curated set of agent skills that teach coding agents how to use [the Stophy CLI](https://www.npmjs.com/package/@stophy/cli).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/stophy-cli.gif\" alt=\"Stophy CLI demo — install package, add skills, login, search\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n## Install\n\n```bash\nnpx skills add https://github.com/stophydotdev/skills --skill --all\n```\n\nOr pick specific skills:\n\n```bash\nnpx skills add https://github.com/stophydotdev/skills --skill stophy-search --skill stophy-video\n```\n\n## Requirements\n\n- Node.js ≥18\n- `@stophy/cli` installed globally: `npm install -g @stophy/cli`\n- An API key from [stophy.dev](https://stophy.dev/dashboard)\n\n## Authentication\n\n```bash\nstophy login --browser           # opens browser\nstophy login --api-key st_xxx    # paste a key directly\nexport STOPHY_API_KEY=st_xxx     # env var also works\n```\n\n**Safety:** treat the API key as a secret. Do not commit it, print it in agent output, or paste it into shared logs. The `STOPHY_API_KEY` value stays in your shell environment.\n\n## Included skills\n\n| Skill | Use it for |\n|-------|------------|\n| `stophy-cli` | Setup, auth, credits, usage, and the full command map |\n| `stophy-search` | Search YouTube by keyword with filters |\n| `stophy-suggest` | Autocomplete / query suggestions for keyword research |\n| `stophy-video` | One video: details, transcript, comments, replies, live chat |\n| `stophy-channel` | Channel videos, Shorts, playlists, about page |\n| `stophy-playlist` | All videos in a playlist with metadata |\n\n## Example commands\n\n```bash\nstophy search --q \"AI coding agents\" --type video --sortBy popularity --uploadDate week\nstophy suggest --q \"how to learn rust\"\nstophy video transcript --url \"https://www.youtube.com/watch?v=h6ukrWyqOm4\"\nstophy video comments --url \"https://www.youtube.com/watch?v=h6ukrWyqOm4\" --sortBy top\nstophy channel --url \"https://www.youtube.com/@t3dotgg\" --tab video --sortBy popular\nstophy playlist --url \"https://www.youtube.com/playlist?list=PLxxxxxx\"\n```\n\n## For agents\n\nPick the narrowest skill for the task. Don't fabricate YouTube data — run the command, inspect the output, then summarize.\n\n| Task | Skill |\n|------|-------|\n| Topic discovery by keyword | `stophy-search` |\n| Keyword or autocomplete research | `stophy-suggest` |\n| Anything about one video (metadata, transcript, comments, replies, live chat) | `stophy-video` |\n| Creator or channel research (catalog, playlists, about page) | `stophy-channel` |\n| Playlist or course research | `stophy-playlist` |\n| Setup, auth, credits, or the full command map | `stophy-cli` |\n\n## Registry\n\n`skills.sh` reads the skill list from `skills.sh.json`:\n\n```json\n[\n  \"stophy-cli\",\n  \"stophy-search\",\n  \"stophy-suggest\",\n  \"stophy-video\",\n  \"stophy-channel\",\n  \"stophy-playlist\"\n]\n```\n\n## Contributing\n\nLayout, conventions, and workflow live in [`AGENTS.md`](./AGENTS.md). Domain vocabulary used across skills is in [`CONTEXT.md`](./CONTEXT.md). Decisions the maintainers have explicitly rejected (and why) live in [`.out-of-scope/`](./.out-of-scope). The Claude Code plugin index is in [`.claude-plugin/plugin.json`](./.claude-plugin/plugin.json).\n\nEvery change goes on a fresh branch off `main`. Commit messages follow Conventional Commits (`feat(scope): subject`, `fix(scope): subject`, `docs(scope): subject`, etc.). Push the branch and open a PR.\n\n## License\n\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstophydotdev%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstophydotdev%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstophydotdev%2Fskills/lists"}