explaingit

mate-matt/matt-skills

★ 14TypeScriptAudience · writerComplexity · 3/5ActiveLicenseSetup · moderate

TLDR

Monorepo of two Codex skills for creators: FxBrief turns X posts into local screenshots, quote cards, and Markdown articles, and Pic Grab finds reusable images with license metadata.

Mindmap

mindmap
  root((matt-skills))
    Inputs
      X post URLs
      Image search queries
      FxEmbed data
    Outputs
      Post screenshots
      Quote cards
      Markdown articles
      Licensed image set
    Use Cases
      Capture X content offline
      Find CC0 images
      Build profile cards
    Tech Stack
      TypeScript
      Bun
      Playwright
      React
      Codex

Things people build with this

USE CASE 1

Generate a 430px mobile-style screenshot of an X post locally without depending on a third-party screenshot site.

USE CASE 2

Export an X Article into Markdown with its images and metadata for archiving or republishing.

USE CASE 3

Find royalty-free CC0 cover images for a slide deck or blog post with a risk rating per source.

USE CASE 4

Render a profile card for an X user with their latest posts attached.

Tech stack

TypeScriptBunPlaywrightReactCodex

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Bun for development plus Playwright browser binaries, and Codex must be restarted after installing the skills.

Code is MIT licensed and free to reuse, but third-party images, X content, and FxEmbed responses are not covered, so the user still has to check usage rights for each asset.

In plain English

matt-skills is a monorepo that bundles together two creator-facing tools built as Codex skills, plus their command-line counterparts. Codex here refers to OpenAI's coding assistant, and a 'skill' is a packaged set of instructions and helper scripts that the assistant can invoke. The repository keeps the AI-facing skill files, deterministic helper scripts written in TypeScript, npm packages, and documentation in one place. The first tool, FxBrief, turns posts from X (formerly Twitter) into local editorial assets you can publish without depending on third-party screenshot sites. It uses FxEmbed for the data, local React or HTML templates for layout, and Playwright to render images. It can produce a 430px mobile-style post screenshot, a cleaner quote card, a profile card (optionally with latest posts), a Markdown export of an X Article with its assets and metadata, a long screenshot of an article with optional numbered slices for social, and raw or normalized JSON of FxEmbed data. The second tool, Pic Grab, finds images you can legally reuse for a cover, illustration, slide deck, or background, and writes out the source URL, creator, license, and a risk rating alongside the file. Its default mode prioritizes CC0 and public-domain sources and tries not to mislabel paid stock platforms as CC0. You can invoke it through the Codex skill or run the Bun script directly with options like --query, --mode strict_cc0, --orientation, and --count. Installation is done through a Codex helper called skill-installer pointed at the GitHub URLs of each skill folder, or by symlinking the skill folders into ~/.codex/skills/ from a local clone. Codex needs to be restarted afterward so it picks up the new skills. Development uses Bun for typecheck, test, build, and fixture rendering, and the fxbrief CLI ships as a scoped npm package at @mate-matt/fxbrief. The code in the repository is MIT licensed, but the README clearly states that third-party images, X content, and FxEmbed responses are not licensed by this repo, so you still need to preserve source links and review usage rights for your own publishing context. The project has 14 stars and is written mainly in TypeScript.

Copy-paste prompts

Prompt 1
Install the FxBrief skill from matt-skills into Codex with skill-installer and capture a screenshot of this X post URL.
Prompt 2
Use the @mate-matt/fxbrief CLI to export an X Article into Markdown with images placed inline.
Prompt 3
Run Pic Grab with mode strict_cc0 and orientation landscape to find five reusable cover images for a blog post about Mediterranean cooking.
Prompt 4
Symlink the matt-skills folders into ~/.codex/skills/ and restart Codex, then list the skills Codex now sees.
Prompt 5
Render a profile card for an X account and include the three latest posts with FxBrief.
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.