matt-fx-brief
Use this skill when asked to render X/Twitter posts, X profiles, or X Articles into local editorial assets with the fxbrief CLI and FxEmbed data. Covers post-mobile, post-clean, profile-card, article-md, article-shot, json/raw-json, translated post body screenshots, Markdown article exports with assets and metadata, X Article long screenshots with optional slices, profile/business-card images, and raw or normalized FxEmbed JSON export.
mate-matt · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add mate-matt/matt-skills --skill matt-fx-briefAbout this skill
name: matt-fx-brief description: Use this skill when asked to render X/Twitter posts, X profiles, or X Articles into local editorial assets with the fxbrief CLI and FxEmbed data. Covers post-mobile, post-clean, profile-card, article-md, article-shot, json/raw-json, translated post body screenshots, Markdown article exports with assets and metadata, X Article long screenshots with optional slices, profile/business-card images, and raw or normalized FxEmbed JSON export.
Matt Fx Brief
Use the globally installed fxbrief CLI to create deterministic local assets from FxEmbed data. Prefer this skill for X/Twitter post screenshots, profile cards, clean editorial quote cards, X Article Markdown archives, and X Article long screenshots.
Do not hand-build screenshots or reconstruct article Markdown manually when fxbrief can export the asset.
CLI Requirement
Use fxbrief 0.2.4 or newer. Check the command from PATH:
fxbrief --version
If it is missing or older than 0.2.4:
npm install -g @mate-matt/fxbrief@latest
Then confirm the expected commands exist:
fxbrief --help
Screenshot commands use Playwright. If Chromium is missing:
npx playwright install chromium
Route The Request
Treat this skill as one X/FxEmbed router. First identify the input shape, then choose the output workflow from the user's intent.
Input Shape
- Profile URL or handle:
https://x.com/user,https://twitter.com/user,@user, oruser. - Status URL or id:
https://x.com/user/status/123,https://twitter.com/user/status/123, or123.
Do not rely on URL shape alone to decide whether a status URL is a normal post or an X Article, because both use /status/<id>. Let the requested output decide. If the user is unclear and the difference matters, inspect the payload with fxbrief json "<url>" --normalized before rendering.
Intent Routing
post-mobile: 430px mobile X-style post screenshot for source-adjacent quotation.post-clean: media/reporting quote card that preserves provenance while reducing the "official X screenshot" feel.profile-card: X profile card for creator/business-card style sharing.article-md: X Article export toarticle.md, localassets/,metadata.json, andraw.fxembed.json.article-shot: X Article long screenshot; add slices for Xiaohongshu, WeChat, Instagram carousels, or other social posting flows.json: raw FxEmbed JSON export for posts, threads, or quote lists. Add--normalizedwhen the user wants fxbrief's local normalized model.
Workflow
- Confirm
fxbrief --versionis0.2.4or newer when using profile cards or JSON export. - Parse the input as either a profile target or a status target.
- Choose the command from the intent:
- Profile card, creator card, business card, homepage screenshot, or X profile: use
profile-card. - Single post screenshot or source quote: use
post-mobileby default. - Clean article/news illustration from a post: use
post-clean. - X Article Markdown, archive, assets, metadata, or local repost source: use
article-md. - X Article long screenshot, carousel, slices, or platform repost images: use
article-shot. - Raw data, metadata inspection, debugging, or integration data: use
json.
- Profile card, creator card, business card, homepage screenshot, or X profile: use
- Run
fxbriefdirectly, using an explicit--outpath when the user needs a stable location. - Verify generated files exist. For
article-md, inspectarticle.mdandmetadata.json. For screenshots, confirm the PNG/WebP path and any slice files. - Report absolute output paths.
Language Handling
For post-mobile and post-clean, if the user asks for a specific language, pass --lang <code> --translated-text so only the post body is translated. If the user asks for translation without naming a language, infer it from the conversation language: use --lang zh-cn --translated-text in Chinese conversations and --lang en --translated-text in English conversations.
Do not translate names, handles, timestamps, metrics, buttons, source footer, or other UI labels. Add --show-translation only when the user explicitly wants both original and translated text visible.
For article-md and article-shot, preserve the original article text unless the user explicitly asks for a translated article. These article commands are usually used to archive or repost the author's own long-form source, so do not infer translation only from the conversation language.
If the user explicitly asks to keep the original language, do not pass --lang or --translated-text.
Commands
Post screenshots:
fxbrief post-mobile "https://x.com/user/status/123" --scale 2
fxbrief post-mobile "https://x.com/user/status/123" --scale 2 --show-subscribe
fxbrief post-clean "https://x.com/user/status/123" --media first --hide-stats
fxbrief post-mobile "https://x.com/user/status/123" --lang zh-cn --translated-text
Profile cards:
fxbrief profile-card "https://x.com/user" --width 430 --scale 2
fxbrief profile-card "https://x.com/user" --latest-post --width 430 --scale 2
fxbrief profile-card "https://x.com/user" --count 3 --width 600 --scale 2
X Articles:
fxbrief article-md "https://x.com/user/status/123"
fxbrief article-shot "https://x.com/user/status/123" --style article-x --width 540 --scale 2
fxbrief article-shot "https://x.com/user/status/123" --style article-x --width 540 --scale 2 --slice-height 1800 --out output/my-article
Data inspection:
fxbrief json "https://x.com/user/status/123"
fxbrief json "https://x.com/user/status/123" --kind thread --normalized --out output/json
Defaults
- Use
--timezone Asia/Shanghaiunless the user asks otherwise. - Use PNG and
--scale 2for screenshot assets. - Keep the source footer by default for editorial provenance.
post-mobilealready defaults to 430px width.profile-carddefaults to 430px width and uses FxEmbed profile data plus local rendering