Skip to content

Guide · Agent skill

How to use the Magazine Article Layout agent skill (article-magazine)

Updated · written with AI from the project's own documentation and checked against our catalogue data

The article-magazine skill is a layout recipe for AI agents. When you ask an agent to turn Markdown or rough notes into an article, it lays the text out as a polished, single-column, magazine-style HTML page. This guide explains what the skill does, how to install it, how to trigger it, and where it fits and doesn't fit. By the end you will be able to add the skill to your agent and get a styled long-form essay from your own draft.

Magazine Article Layoutnexu-io/open-design · Apache-2.0

Quick start

  1. 1Download the ZIP. Get the article-magazine ZIP from the skill page you are reading.
  2. 2Unzip into a skills folder. Extract it into ~/.claude/skills/ for personal use, or into your project's .claude/skills/ folder.
  3. 3Or upload in the Claude apps. In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the ZIP.
  4. 4Prepare your content. Write or paste your draft in Markdown, using headings, blockquotes and fenced code where they fit.
  5. 5Ask for the layout in plain language. Request a magazine-style long-form HTML essay from your notes and say you want real content, not placeholders.
  6. 6Review the HTML. Open the generated page in a browser and check headings, quotes, code blocks and the closing card.

What the article-magazine skill makes the agent do

An agent skill is a folder of instructions that an AI agent can load when a task matches it. This one is described in a file called SKILL.md, and it tells the agent how to lay out long-form content. The output is a single-column web page, centred with a maximum width of about 700px, with a large headline and an optional subtitle and author, reading time and date line.

The layout follows a visual template inspired by the Huashu / huashu-md-html style, a Chinese-language HTML layout style. Body text uses large, relaxed type. Section headings use a serif font so they contrast with the body. Quotes get a thick accent-coloured left border and italic text. Code blocks have rounded corners, a dark background, light text and a language label. List bullets are custom squares or accent dots. Sections are separated by centred ornaments, and the page ends with a simple "If you found this useful, feel free to share" card.

The package includes an example page (example.html) so you can see the finished look before you use it.

Install the article-magazine skill

Download the ZIP for this skill from the page you are reading. Then choose one of two routes.

For a personal install that works across your projects, unzip the download into ~/.claude/skills/. For a single project, unzip it into that project's .claude/skills/ folder instead.

If you use the Claude apps, you can upload the skill instead. Open Settings, go to Capabilities, then Skills, and upload the ZIP there.

  • Personal: ~/.claude/skills/
  • Project only: .claude/skills/ inside your project
  • Claude apps: Settings → Capabilities → Skills

Trigger the skill with a natural request

You don't need a special command. Once the skill is installed, describe what you want in plain language and mention the article or essay layout. The skill's description covers turning Markdown or notes into a long-form HTML essay, so requests that match that task are the ones most likely to load it.

The source's example prompt is a good model. It asks for the Magazine Article template, real content and data, and no lorem ipsum or placeholder images. Adapt it to your own material.

  • "Turn my notes in notes.md into a magazine-style long-form HTML essay."
  • "Lay out this Markdown draft as a polished article with a large headline and styled quotes."
  • "Use the Magazine Article layout to make my newsletter draft into an HTML page, with real content and no placeholder images."

Get a good result from your input

The skill styles what you give it, so the input matters. Clear headings and paragraphs give the agent a structure to follow. Real quotes, code snippets and links will appear in the layout where they belong, because the template includes styled blocks for them.

The example in the source is an essay built from a Markdown post with a linked source note, so it shows how links and attribution can sit inside the article.

  • Use Markdown headings (#, ##) to mark sections.
  • Put quotes in blockquotes so they get the styled quote treatment.
  • Put code in fenced blocks so it gets the dark code style and language label.
  • Include a title and, if you have one, a subtitle and author name for the hero area.

Safety, requirements and what the skill does not do

According to the skill's metadata, it requires nothing beyond the agent itself, does not run scripts, and does not use the network. The package contains three files: SKILL.md, an example page and open-design.json. Because it runs no scripts and makes no network calls, the risk is mainly in the instructions and the content you feed it.

The template defines its own look. It does not require a design system, so it is not the right choice if your project must follow a specific brand design system. It also produces styled HTML, so it is not suited to a CMS that strips HTML or CSS and needs plain output.

  • Runs scripts: no
  • Uses network: no
  • Requires: nothing listed
  • Files: SKILL.md, example.html, open-design.json

What people use it for

  • Turning a rough blog draft into a styled long-form essay for a personal site.
  • Producing a newsletter-style article page from a set of notes.
  • Creating a readable, styled HTML version of a Markdown draft for review.
  • Building a long-form content page for a marketing campaign.

Frequently asked questions

How do I install the article-magazine skill?

Download the ZIP from the skill page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps, you can instead upload the ZIP under Settings, Capabilities, then Skills.

Does the article-magazine skill require anything else?

The skill's metadata lists no requirements. It does not run scripts and does not use the network, according to the source.

Is the article-magazine skill free?

The skill is published under the Apache-2.0 licence. The source does not list any price, so check the licence text for the terms that apply.

What can I turn into an article with this skill?

It is designed for turning Markdown or notes into a polished long-form HTML essay. Bloggers, newsletter writers, marketers and students with a Markdown draft are the intended users.

Why does my output not look like the example?

The skill applies a fixed magazine template with serif headings, styled quotes and code blocks. If your output looks plain, check that the skill is installed in the folder your agent reads and that your request asks for the magazine article layout.

Can I use this skill with a CMS?

Only if your CMS accepts HTML and CSS. The skill produces styled output, so a CMS that strips HTML or CSS will not show the layout as designed.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use article-magazine if you want a polished, single-column HTML essay from rough Markdown or notes, and you don't mind the template defining its own look. Pick something else if your project must follow a specific brand design system, or if your platform strips HTML and CSS and you need plain output.

Download the skill