New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Dev Diary Mdx

by MillenniumDawn in MillenniumDawn/Millennium-Dawn

Convert a Millennium Dawn dev diary .docx into a publish-ready .mdx for the docs site: frontmatter, headers, and images placed in reading order, with the author's voice preserved.

CC-BY-SA-4.0Auto-check passedDocuments & Office

Install Dev Diary Mdx

skills CLI
$ npx skills add MillenniumDawn/Millennium-Dawn --skill dev-diary-mdx -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MillenniumDawn/Millennium-Dawn dev-diary-mdx --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MillenniumDawn/Millennium-Dawn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/dev-diary-mdx .claude/skills/dev-diary-mdx && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dev-diary-mdx
GitHub stars
137
Token cost
~958 tokens
SKILL.md length
459 words
Files
2
Skills in repo
24
Repo updated
First seen
Licence
CC-BY-SA-4.0

At a glance

Convert a Millennium Dawn dev diary .docx into a publish-ready .mdx for the docs site: frontmatter, headers, and images placed in reading order, with the author's voice preserved.

  • Works in 6 steps: Get the .docx → Number → Extract → …
  • Given a dev-diary .docx to format
  • SKILL.md covers Preserve the author's voice, 1. Get the .docx, 2. Number and 3. Extract, plus 3 more sections
  • Runs Python scripts from its folder; calls bun, python and prettier

What it does

Dev Diary Mdx is an agent skill from MillenniumDawn/Millennium-Dawn. Convert a Millennium Dawn dev diary .docx into a publish-ready .mdx for the docs site: frontmatter, headers, and images placed in reading order, with the author's voice preserved. Use when given a dev-diary .docx to format or publish, or "dev diary 057"-style numbering.

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `extract_docx.py`).

It sits in Documents & Office, covering Journaling and reflection, Markdown and Word documents. It works with Microsoft Word. The repository describes itself as: Millennium Dawn and it's codebase. The licence is CC-BY-SA-4.0.

When your agent uses it

  • Given a dev-diary .docx to format
  • Dev diary 057-style numbering

Example prompts

  • “dev diary 057”
  • “/dev-diary-mdx”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Get the .docx
  2. Number
  3. Extract
  4. Frontmatter
  5. Assemble
  6. Report

What it can do on your machine

Read from SKILL.md and the folder at commit 5821281. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • bun
    • python
    • prettier

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dev Diary Mdx loads about 958 tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 459 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~958

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MillenniumDawn/Millennium-Dawn at commit 5821281, republished under its CC-BY-SA-4.0 licence (© MillenniumDawn). 459 words, ~958 tokens.

Download SKILL.mdSave it as .claude/skills/dev-diary-mdx/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
dev-diary-mdx
description
Convert a Millennium Dawn dev diary .docx into a publish-ready .mdx for the docs site: frontmatter, headers, and images placed in reading order, with the author's voice preserved. Use when given a dev-diary .docx to format or publish, or "dev diary 057"-style numbering.

Dev Diary to MDX

The job is structure, not editing. Scaffold the MDX and place the images. Leave the author's prose as written.

Preserve the author's voice

  • Do not proofread, normalize, reword, reorder, or delete text.
  • Keep casual spellings, run-on sentences, asides, jokes, smart quotes, and the author's own hyphenation. Keep stylistic ellipses (…., ....) exactly.
  • The only allowed change to source text is splitting a paragraph at a sentence boundary so an image can sit beside the passage it illustrates.
  • Convert an em dash in the source to a period, comma, or colon.
  • Text you author (headers, alt text) uses no em dash and no ....
  • Proofreading is a separate task, only on request, with every change listed.

1. Get the .docx

Use the path in $ARGUMENTS or the attached file. Otherwise ask for it before doing anything else. A Google Doc exports with Download, Microsoft Word (.docx). Reject other formats.

2. Number

Take the highest NNN- prefix in docs/src/content/devDiaries/*.mdx, add 1, and zero-pad to 3 digits. Warn if docs/src/assets/images/dev-diaries/<NNN>/ exists.

3. Extract

bash
python .claude/skills/dev-diary-mdx/extract_docx.py \
  --docx "<path to .docx>" \
  --image-dir docs/src/assets/images/dev-diaries/<NNN>

It copies every embedded image, in document order, to picture-1.png, picture-2.png, and so on, and prints JSON with title, blocks (heading, para, and image entries in source order), and images.

4. Frontmatter

Ask for what cannot be derived, offering defaults:

  • title: the JSON title or first heading, as "Dev Diary #NN: <Title>" with NN unpadded.
  • description: one line.
  • author: the real developer handle, not the in-character narrator.
  • version: default v2.0. It must match ^v\d+\.\d+$ or bun run check fails.
  • date: default today, YYYY-MM-DD.

The slug is the kebab-cased title without the "Dev Diary #NN:" prefix. The permalink is /dev-diaries/<N>-<slug>/ with the unpadded number. The filename is <NNN>-<slug>.mdx.

Show full SKILL.md (181 more words)Show less

5. Assemble

Write docs/src/content/devDiaries/<NNN>-<slug>.mdx, UTF-8 without BOM:

mdx
---
title: "Dev Diary #58: Greenland"
description: <one line>
permalink: /dev-diaries/58-greenland-holiday-paradise/
author: Luigi
date: 2026-06-12
version: "v2.0"
tags:
  - dev diary
---

_By Luigi – 12 June 2026_

<body>
  • No # H1. The body opens with the italic byline.
  • Keep the intro and sign-off without headers. Add ## or ### only at real topic shifts. Honor the docx's heading styles. For flat prose, add headers in the diary's own wording.
  • Every extracted image goes into the body. Place each one right after the sentence that introduces it, following the prose cues ("the first picture shows", "the next pictures in order are"). Word often dumps all screenshots at the top, so prefer the cues over block position.
  • When one paragraph describes two visuals, split it so each image sits with its passage.
  • With no cue, place the image where it sits in the blocks order and report it.
  • Image form, with an absolute path: ![picture1](/assets/images/dev-diaries/<NNN>/picture-1.png).

6. Report

  • The .mdx path and the image folder.
  • How many images were placed, and which had no cue.
  • A reminder to check author, version, and date against an existing diary.
  • Checks to run from docs/: bun run lint:md, bun run lint:remark, prettier --write on the new file, and bun run check.

© MillenniumDawn, CC-BY-SA-4.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .claude/skills/dev-diary-mdx of MillenniumDawn/Millennium-Dawn.

  • SKILL.md
  • extract_docx.py

Open the folder on GitHubat commit 5821281

Compare with similar skills

Dev Diary Mdx next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dev Diary Mdx compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dev Diary Mdx this skillMillenniumDawn/Millennium-Dawn137—~958Automated safety check: PassCC-BY-SA-4.0
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0
Pandoc DOCX TemplateAchuan-2/pandoc_docx_template1.1k—~1kAutomated safety check: PassNone
Markitshift-labs-ai/markit1.3k—~299Automated safety check: PassMIT
Personal Ip Knowledge Builderlimecloud/lime1.5k—~892Automated safety check: PassApache-2.0

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes

  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed

  • Pandoc DOCX Template

    Achuan-2/pandoc_docx_template

    A skill your agent uses when converting Markdown to Word DOCX or DOCX back to Markdown with Pandoc, especially when the output should use the bundled Chinese Word reference templates, heading…

    1.1k GitHub stars~1k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed

  • Markit

    shift-labs-ai/markit

    Convert files and URLs to Markdown. An agent skill from shift-labs-ai/markit.

    1.3k GitHub stars~299 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

  • Personal Ip Knowledge Builder

    limecloud/lime

    将访谈稿、聊天记录、简历、公开内容、业务资料、案例和既有 DOCX/Markdown 文档，提炼成可被 AI 长期调用的个人 IP 知识库。适用于用户要求“生成个人知识库”“整理成个人 IP 成品知识库”“为创始人/专家/讲师/主播/顾问建立AI知识库”“把资料变成个人IP底层提示词/写作风格库/故事素材库/话术库”的场景。

    1.5k GitHub stars~892 tokensUpdated today
    Documents & OfficeAuto-check passed

  • Suiko

    nwiizo/suiko

    日本語文書のAI由来の均一さ、翻訳調、不自然さ、論旨、読解負荷を、決定的なRust CLIと目視で診断し、依頼に応じて書く・直す。日本語の学術論文・研究報告では、中心命題、用語、論証、DOCX/PDF納品を監査契約で確認する。Use when the user explicitly mentions suiko, asks whether Japanese text looks…

    114 GitHub stars~1.8k tokensUpdated today
    Documents & OfficeAuto-check passed

More from MillenniumDawn/Millennium-Dawn

All 24 skills in this repo

  • Country AI Path

    MillenniumDawn/Millennium-Dawn

    Build or standardise one country's TAGaibehavior AI path game rule — write the rule options and loc, wire the global flags, own the focus weights, run the AI hardening pass, and open the PR.

    137 GitHub stars~2.5k tokensUpdated today
    Auto-check passed

  • Md Tick Profiler

    MillenniumDawn/Millennium-Dawn

    Profile MD's recurring per-tick scripted workload (the daily/weekly/monthly onaction hooks and everything they run) as a flamegraph sized by script ops, plus a text report.

    137 GitHub stars~816 tokensUpdated today
    Auto-check: notes

  • Add Leader

    MillenniumDawn/Millennium-Dawn

    Scaffold generals, field marshals, and admirals for a country using the MD count formulas and region skill ranges, writing character and recruitcharacter entries.

    137 GitHub stars~717 tokensUpdated today
    Auto-check passed

  • Additional Income

    MillenniumDawn/Millennium-Dawn

    Wire a country-specific income or expense stream into the MD money system: calculation block, hidden tooltip idea, loc key, and granting effect.

    137 GitHub stars~664 tokensUpdated today
    Auto-check passed

  • Fix Issue

    MillenniumDawn/Millennium-Dawn

    Find an actionable open GitHub issue (or take an issue number or quoted task), implement the fix, commit, update the changelog, and open or update a PR.

    137 GitHub stars~988 tokensUpdated today
    Auto-check passed

  • New Namelist

    MillenniumDawn/Millennium-Dawn

    Scaffold division name lists, ship hull names, ship class design names, and air wing name blocks for a country.

    137 GitHub stars~739 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Dev Diary Mdx

What does Dev Diary Mdx do?

Convert a Millennium Dawn dev diary .docx into a publish-ready .mdx for the docs site: frontmatter, headers, and images placed in reading order, with the author's voice preserved. Dev Diary Mdx is an agent skill from MillenniumDawn/Millennium-Dawn.mdx for the docs site: frontmatter, headers, and images placed in reading order, with the author's voice preserved.

When should I use Dev Diary Mdx?

Dev Diary Mdx fits situations like: given a dev-diary .docx to format; dev diary 057-style numbering.

How do I install Dev Diary Mdx in Claude Code?

Run `npx skills add MillenniumDawn/Millennium-Dawn --skill dev-diary-mdx -a claude-code`. Or copy the skill folder (.claude/skills/dev-diary-mdx in MillenniumDawn/Millennium-Dawn) into .claude/skills/dev-diary-mdx in your project. Claude Code loads it when a task matches its description.

How do I install Dev Diary Mdx in Codex?

Run `npx skills add MillenniumDawn/Millennium-Dawn --skill dev-diary-mdx -a codex`. Or copy the skill folder (.claude/skills/dev-diary-mdx in MillenniumDawn/Millennium-Dawn) into .agents/skills/dev-diary-mdx in your project. Codex loads it when a task matches its description.

Can I use Dev Diary Mdx in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MillenniumDawn/Millennium-Dawn --skill dev-diary-mdx -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dev-diary-mdx, .gemini/skills/dev-diary-mdx, .github/skills/dev-diary-mdx and .opencode/skills/dev-diary-mdx in your project.

What does Dev Diary Mdx need to run?

Going by SKILL.md and its folder, Dev Diary Mdx needs Python for the scripts in its folder and the command-line tools its instructions call (bun, python and prettier). Our summary lists: Python 3.

Does Dev Diary Mdx access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dev Diary Mdx safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dev Diary Mdx use?

Dev Diary Mdx is published under the CC-BY-SA-4.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dev Diary Mdx use?

About 958 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dev Diary Mdx?

Skills that share tags, products or a category with Dev Diary Mdx: Markitdown (ImCa0/just-laws, 781 stars), Gzh Design (isjiamu/gzh-design-skill, 3.9k stars), Pandoc DOCX Template (Achuan-2/pandoc_docx_template, 1.1k stars) and Markit (shift-labs-ai/markit, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dev Diary Mdx?

MillenniumDawn (a GitHub organization) maintains it in MillenniumDawn/Millennium-Dawn, which has 137 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 8, 2026.

Source: MillenniumDawn/Millennium-Dawn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.