ljg-x-download
从 X (Twitter) 链接下载图片或视频到 ~/Downloads。
Works with
Installation Guide
How to use ljg-x-download on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your machine
- ›Node.js 16+ with npm — verify with
node --version - ›Active project directory where you want to add
ljg-x-download
Run the install command
Execute the skills CLI command in your project's root directory to begin installation:
Fetches ljg-x-download from lijigang/ljg-skills and configures it for Cursor.
Select Cursor when prompted
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate ljg-x-download. Access via /ljg-x-download in your agent's command palette.
Security Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Documentation
ljg-x-download
从 X (Twitter) 链接下载图片或视频到 ~/Downloads。
依赖
yt-dlp(已安装)
执行流程
1. 解析输入
从用户输入中提取 X/Twitter URL。支持的格式:
https://x.com/user/status/123456https://twitter.com/user/status/123456https://mobile.twitter.com/user/status/123456- 带查询参数的 URL(yt-dlp 自动处理
?s=20等追踪参数)
缩短链接(t.co)先解析:curl -Ls -o /dev/null -w '%{url_effective}' "SHORT_URL"
如果用户没有提供 URL,用 AskUserQuestion 要求提供。
2. 尝试直接下载(视频优先)
直接用 yt-dlp 下载,无需先探测:
yt-dlp -o "~/Downloads/%(uploader)s_%(id)s.%(ext)s" "URL"
如果成功(视频推文),完成。跳到步骤 4 汇报结果。
3. 视频下载失败时,提取图片
yt-dlp 对纯图片推文可能报错。此时用 --dump-json 提取图片 URL:
yt-dlp --dump-json "URL" 2>&1
判断结果:
- JSON 中有
thumbnails数组 → 提取图片 URL - JSON 为空或报错
no video→ 推文无媒体,告知用户"该推文不包含可下载的图片或视频" - 报错含
login/authentication→ 需要登录(见故障排除) - 其他错误 → 报告具体错误信息
图片下载:
从 JSON 的 thumbnails 数组提取所有图片 URL,替换 name=small 或 name=medium 为 name=orig 获取原图,然后逐一下载:
curl -L -o ~/Downloads/tweet_ID_1.jpg "https://pbs.twimg.com/media/xxx?format=jpg&name=orig"
curl -L -o ~/Downloads/tweet_ID_2.jpg "https://pbs.twimg.com/media/yyy?format=jpg&name=orig"
文件扩展名跟随 URL 中的 format 参数(jpg/png/webp)。
4. 汇报结果
下载完成后,用 ls -lh 列出已下载的文件:文件名、大小、路径。
故障排除
需要登录
yt-dlp 报错含 login / Sign in / age-restricted 时,加 --cookies-from-browser chrome:
yt-dlp --cookies-from-browser chrome -o "~/Downloads/%(uploader)s_%(id)s.%(ext)s" "URL"
推文无媒体
纯文字推文没有可下载的媒体。告知用户即可。
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases
User Story & Requirements Generation
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Competitive Analysis
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Roadmap Prioritization
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale