agentleFS
badDevBuildbadDevBuild/md2poster-skill/markdown-to-poster-skill/SKILL.md

markdown-to-image

Skill1 starsChanged 9 months agoMITView on GitHub

Converts a markdown string or file into a high-quality PNG image using markdown-to-poster and Puppeteer.

  • Installs packages

4 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions4 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 4

    1. zephyrwang6/myskill★ 339same name
    2. yijingjia/skills★ 70same name
    3. SpaceZephyr/allSkills★ 14same name
    4. cocyuhao/my-ai-skills-library★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When invoking this skill, automatically select suitable themes based on the content's tone and topic if the user hasn't specified one.

    line 37

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Markdown to Image Skill

This skill allows you to convert Markdown content into a visually appealing image (poster style). It spins up a temporary local Vite server to render the content with React and uses Puppeteer to capture a screenshot.

Prerequisites

  • Node.js (v18+)
  • Dependencies installed within the skill's app directory:
    cd <skill-root>/app
    npm install

Usage

You can use this skill by running the render.js script.

Command

node <skill-root>/render.js <input_markdown_file> [output_image_file] [theme] [size] [template]
  • <input_markdown_file>: Absolute path to the markdown file.
  • [output_image_file]: (Optional) Defaults to ~/Downloads/markout/<filename>.png.
  • [theme]: (Optional) Theme name. See selection guide below.
  • [size]: (Optional) pc (wide) or mobile (default, narrow).
  • [template]: (Optional) basic (default) or others if implemented.

Theme Selection Guide

When invoking this skill, automatically select suitable themes based on the content's tone and topic if the user hasn't specified one.

Theme NameStyle KeywordsBest For
notion / notion-lightMinimalist, Clean, Light, Sans-serifDocumentation, Notes, Daily Reports, General Knowledge
lapisBlue/White, Academic, Elegant, Serif/Sans mixResearch Papers, Essays, Deep Dives, Technical Analysis
bronyaLight Grey, IDEA Code style, Warm accentsDevlogs, Tutorials, Coding heavy articles with a softer UI
neon / lcarsDark, Star Trek, Sci-Fi, High Contrast, Black BGTech News, Sci-Fi Reviews, "Geek" content, CLI logs
cyberpunkDark, Glitch, Neon Blue/Pink, Retro-futureGaming, Cyber Security, Edgy Tech, Crypto
torillicParchment, Serif, Classic, Multi-columnHistory, Literature, Poetry, Storytelling, Fantasy
phycat-prussian (Default)Prussian Blue, Professional, CleanCorporate Reports, Official Announcements, Business

Examples

1. Daily Report (Clean/Professional):

node render.js input.md output.png notion mobile

2. Coding Tutorial (Dev focused):

node render.js input.md output.png bronya pc

3. Sci-Fi Story:

node render.js input.md output.png neon mobile

Troubleshooting

  • Puppeteer Instablity: Requires system Chromium libraries.
  • Port Conflict: Automatically detects Vite port.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.