Skip to content

devhims/video2ctx / .agents/skills/video2ctx-platform

video2ctx-platform

Verified

Managed, hosted YouTube context for production and cloud-backed applications. Use for authenticated search, transcripts, video and channel metadata, caption tracks, comments, end screens, playlists, account identity, usage and credits, recurring monitors, notifications, and delivery preferences. Also use as a fallback when direct local access fails. Requires a video2ctx account and its public CLI.

FileKindSize
SKILL.mdskill md3.5 KB
agents/openai.yamlconfig260 B
references/hosted-data.mdmarkdown3.3 KB
references/monitoring.mdmarkdown2.3 KB

references/hosted-data.md

View on GitHub
# Hosted data workflow

Use this workflow for stateless managed data, account identity, usage or credits, production application access, and automatic fallback after a `youtube-ctx` direct operation fails.

## Use the shortest route

For a known YouTube URL or video ID, fetch compact transcript text in one data request:

```bash
video2ctx transcript '<youtube-url-or-id>' --format text --include-meta
```

Add `--lang <code>` only when a particular output language is requested. Use `--format segments` for segment timestamps or `--format words` only for word timing.

For other operations, percent-encode query values and replace brace placeholders with IDs.

| Need | Command |
| --- | --- |
| Search | `video2ctx api GET '/v1/search?provider=youtube&q=<encoded>' --include-meta` |
| Browse | `video2ctx api GET '/v1/browse?provider=youtube' --include-meta` |
| Video details | `video2ctx api GET '/v1/videos/{id}?provider=youtube' --include-meta` |
| Caption tracks | `video2ctx api GET '/v1/videos/{id}/tracks?provider=youtube' --include-meta` |
| Transcript | `video2ctx api GET '/v1/videos/{id}/transcript?provider=youtube&format=text' --include-meta` |
| Comments | `video2ctx api GET '/v1/videos/{id}/comments?provider=youtube' --include-meta` |
| End screen | `video2ctx api GET '/v1/videos/{id}/endscreen?provider=youtube' --include-meta` |
| Channel details | `video2ctx api GET '/v1/channels/{id}?provider=youtube' --include-meta` |
| Channel videos | `video2ctx api GET '/v1/channels/{id}/videos?provider=youtube' --include-meta` |
| Channel playlists | `video2ctx api GET '/v1/channels/{id}/playlists?provider=youtube' --include-meta` |
| Playlist | `video2ctx api GET '/v1/playlists/{id}?provider=youtube' --include-meta` |
| Usage and balance | `video2ctx api GET '/v1/usage' --include-meta` |
| Account identity | `video2ctx whoami --json` |

Every provider read requires `provider=youtube` in the query; do not spend a request discovering it through `/v1/providers`. Provider listing and usage are free. Most provider reads cost 1 credit; a fresh search or comments request costs 2 credits. `--include-meta` exposes settled credit and request metadata.

## Bound the workflow

- Request only the resource or detail level needed.
- Return a continuation only to the exact endpoint and encoded query that produced it.
- Inspect `data.meta.partial` and `data.meta.warnings` before presenting a result as complete.
- The CLI uses a 150-second data deadline by default and permits `--timeout-ms` from 1,000 through 300,000.
- The CLI retries idempotent GET requests once after `429` or `503`, honoring `Retry-After`; change the bounded attempt count with `--retries 0..3`.

Read `https://docs.video2ctx.dev/api/discovery.md` or the relevant data guide only when a requested route or parameter is not covered here.

Stay within stateless hosted data, account identity, and usage. Projects, research, imports, exports, billing, API-key management, connected-account changes, account deletion, and administration are outside this workflow. Direct the user to `https://video2ctx.dev` for browser-only account actions.

## Completion criteria

The minimum production request completed; no unnecessary provider discovery or documentation request was made; partial results and continuations retain their meaning; and settled credit or classified error metadata was preserved.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall