ceshine/youtube-tools
youtube-tools/SKILL.md
Fetch transcripts and create structured watching guides / summaries for YouTube videos. Use when the user asks to (1) get, fetch, extract, or download a transcript or captions from a YouTube video URL, or (2) summarize, create a watching guide, or produce a structured summary of a YouTube video. Trigger on youtube.com/watch, youtu.be, or youtube.com/shorts links.
$ install --global
skillsauthnpx skillsauth add ceshine/ceshine-agent-skills youtube-toolsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 8:10 PM2.0s1 file scanned
SKILL.md
- name:
- youtube-tools
- description:
- Fetch transcripts and create structured watching guides / summaries for YouTube videos. Use when the user asks to (1) get, fetch, extract, or download a transcript or captions from a YouTube video URL, or (2) summarize, create a watching guide, or produce a structured summary of a YouTube video. Trigger on youtube.com/watch, youtu.be, or youtube.com/shorts links.
YouTube Video Tools
Fetch YouTube video transcripts and produce structured watching guides via the defuddle CLI (npx defuddle from the npm registry).
Fetching Transcripts
npx defuddle parse <youtube-url> --markdown
Always use --markdown to get the transcript in readable Markdown format.
Options
--lang <code>— request a specific language (BCP 47, e.g.en,ja,zh).-o <file>— write output to a file instead of stdout.
Notes
- Videos without captions will return no transcript.
- The output includes a link to the video, the video description, and timestamped transcript segments.
Creating a Watching Guide
A watching guide is a structured summary that breaks a video into segments with summaries and highlighted quotes. Use this workflow when the user asks to summarize a video or create a watching guide.
Workflow
- Fetch the transcript using
npx defuddle parse <url> --markdown. - Analyze the transcript — identify natural topic boundaries, key quotes, and timestamps.
- Produce the watching guide in the Markdown format below.
- Save the output to a file (default:
watching-guide.md, or as the user specifies).
Timestamp Links
Convert transcript timestamps (MM:SS or HH:MM:SS) to YouTube deep links:
https://www.youtube.com/watch?v=VIDEO_ID&t=TOTAL_SECONDSs
Example: 0:09:57 → &t=597s (9×60 + 57 = 597).
Output Format
# Watching guide — [Video Title]
*[Brief description, e.g. "Host interviews Guest"] · ~[duration] · [video link]*
---
### `00:00 – 02:00` [Segment Title]
[► 0:00](<video-link>&t=0s)
[2–4 sentence summary of this segment.]
**Highlights**
> *"Verbatim quote from the transcript."*
> [0:01:30](<video-link>&t=90s)
> *"Another notable quote."*
> [0:01:55](<video-link>&t=115s)
---
### `02:00 – 10:30` [Next Segment Title]
[► 2:00](<video-link>&t=120s)
[Summary paragraph.]
**Highlights**
> *"Key quote."*
> [0:05:12](<video-link>&t=312s)
Guidelines
- Aim for 5–12 segments depending on video length.
- Each segment summary should be 2–4 sentences capturing the essence, not a transcript.
- Pick 1–3 of the most impactful or memorable quotes per segment as highlights.
- Use the exact wording from the transcript for quotes — do not paraphrase.
- Omit the Highlights section for a segment if there are no standout quotes.
- Timestamp links must point to the correct time in the video.
Related Skills
ceshine/web-search-and-fetch
tools
VerifiedTrustedCommunity
Run Google searches and fetch JS-rendered web pages as Markdown via `google-search-cli`, a Patchright-based CLI invoked through `uvx` from its GitHub repo (no local install needed). Use when the agent needs (1) fresh Google search results from a query, (2) the Markdown of a URL that plain HTTP fetch (curl/WebFetch) cannot render because it requires JavaScript or evades bots, or (3) inspection of the raw HTML of a Google results page. Trigger phrases include "google for ...", "search the web for ...", "fetch this page as markdown", "this page needs JS to render". Do not use for static doc URLs that WebFetch handles cleanly, or when Chromium cannot be installed on the machine.
1SKILL.mdUpdated Apr 17, 2026
ceshine/using-skills
tools
VerifiedTrustedCommunity
Always use this skill at the beginning of a session. It establishes how to find and use skills, and requires relevant Skill tool invocation before ANY response including clarifying questions
1SKILL.mdUpdated Apr 17, 2026
ceshine/skill-creator
tools
VerifiedTrustedCommunity
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends the agent's capabilities with specialized knowledge, workflows, or tool integrations.
1SKILL.mdUpdated Apr 17, 2026
ceshine/markdown-dot-new
development
VerifiedTrustedCommunity
Retrieve the Markdown version of a public web page from a URL using the agent's built-in URL fetch capability and markdown.new. Use when a user asks for page content in Markdown, cleaner extracted page content for LLM use, or URL-to-Markdown conversion.
1SKILL.mdUpdated Apr 17, 2026