upgrading-emdash

upgrading-emdash is a skill for Claude Code, Codex from emdash-cms/emdash. It costs 72 tokens per session (611 once invoked), scanned A, original, MIT.

A workflow for upgrading an existing EmDash project and applying the required package, skill, and migration changes.

In plain words
What is it for?
Use it to run the EmDash updater, read its generated work order, apply required source or configuration changes, and verify the result.
Why use it?
It separates dependency updates from application edits, database migrations, and deployment, reducing the risk of treating an upgrade as complete when project-specific work remains.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to run the EmDash updater, read its generated work order, apply required source or configuration changes, and verify the result.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/emdash-cms/emdash/upgrading-emdash
About the project

EmDash is a content management system for creating and managing websites, built with TypeScript and Astro and deployable on Cloudflare or Node.js with SQLite. It is for site owners and developers who want WordPress-like administration, templates, and plugins without PHP or separate hosting.

emdash-cms/emdash · 13,659 stars · on GitHub · emdashcms.com

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add emdash-cms/emdash --skill upgrading-emdash
Clone the repo
git clone --depth 1 https://github.com/emdash-cms/emdash

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for upgrading-emdash

README.md
[![agentmods](https://agentmods.dev/badge/skills/emdash-cms/emdash/upgrading-emdash/github.svg)](https://agentmods.dev/skills/emdash-cms/emdash/upgrading-emdash)
Your own site
<a href="https://agentmods.dev/skills/emdash-cms/emdash/upgrading-emdash"><img src="https://agentmods.dev/badge/skills/emdash-cms/emdash/upgrading-emdash/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for upgrading-emdash

Your own site · 80×15
<a href="https://agentmods.dev/skills/emdash-cms/emdash/upgrading-emdash"><img src="https://agentmods.dev/badge/skills/emdash-cms/emdash/upgrading-emdash.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 72 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 611 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00072 $0.00611
Opus 5.5 $0.00029 $0.00244
Sonnet 5.5 $0.00014 $0.00122
Haiku 4.5 $0.00007 $0.00061

Measured 9d ago against content hash a942be1d972e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

upgrading-emdash scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/upgrading-emdash/SKILL.md · 34 lines

How it starts

The opening of the file, as written. The whole thing — 34 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Upgrading EmDash

Use upgrade-emdash to resolve the selected npm release tag, update every direct EmDash package, refresh the EmDash skills, and create the project-specific work order. The updater does not edit application code, apply database migrations, or deploy.

Prepare the work order

Run from the project root:

npx upgrade-emdash@latest --dry-run
npx upgrade-emdash@latest

Use --to <tag> for another npm dist-tag such as next or beta. --to does not accept a version. Use --yes to accept the updater prompt in a non-interactive environment, --json for a machine-readable dry-run, and --cwd <path> when the project root is elsewhere.

The updater writes .emdash/UPGRADE.md. Read that file after the command finishes. It contains the complete authored changelog entries crossed by the direct packages in this project, with generated dependency-bump entries removed, plus the exact core migration delta found after installation.

Complete the upgrade

  1. Inspect the existing project and its uncommitted changes. Preserve unrelated work.
  2. Assess every release entry in .emdash/UPGRADE.md against the project. Apply required source and configuration changes. Do not adopt a new feature when the project does not use the affected surface.
  3. Run the repository's relevant format, tests, typecheck, and build commands.
  4. Run the migration status command from the work order and report the target database and pending migrations.
  5. When the work order lists added core migrations, the status command reports an earlier pending migration, or a release entry requires a data-changing project action, follow the work order's backup procedure before starting or deploying the upgraded application.
  6. Ask before applying a migration to a database, deploying, or making any other remote change unless the user explicitly included that action in the request.
  7. After authorized migration and deployment work, run the migration check and verify the affected site paths.

Read the full file on GitHub · 34 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 34 lines · 72 tokens per session scan A a942be1d972e

Subscribe to this mod's changes

upgrading-emdash is a skill published in the GitHub repository emdash-cms/emdash (13,659 stars, last pushed today), licensed MIT. It adds 72 tokens to every session and 611 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-07.

Related

Other skills, from other repositories

creating-plugins

Create EmDash CMS plugins with sandboxed hooks, routes, storage, content and media APIs, MCP tools, and declarative admin UI, or native React and Astro extensions. Use when scaffolding or implementing an EmDash plugin.

EngDawood/emdash-claude-plugin · 50 tokens

emdash-cli

Use the EmDash CLI to inspect and manage an EmDash instance from the command line, including content, schema, media, taxonomies, menus, search, authentication, seeds, migrations, generated types, and whole-site export and import.

EngDawood/emdash-claude-plugin · 52 tokens

wordpress-plugin-to-emdash

Analyze and port WordPress plugin behavior, custom post types, shortcodes, admin workflows, and stored data to current EmDash extension points. Use for WordPress-plugin migrations or when deciding which behavior belongs in an EmDash plugin, site schema, seed, or Astro code. Do not use for visual theme ports without…

EngDawood/emdash-claude-plugin · 73 tokens

building-emdash-site

Build the site-facing parts of an EmDash CMS project on Astro, including schema and seeds, content queries, Portable Text rendering, menus, taxonomies, widgets, and deployment configuration. Use for EmDash site and theme work; use creating-plugins instead when the task is plugin authoring alone.

EngDawood/emdash-claude-plugin · 66 tokens

emdash-github-actions

Sets up GitHub Actions CI/CD workflows for EmDash plugins — TypeScript type-checking, ESLint linting, Vitest testing, npm publishing, and automated releases. ALWAYS use this skill when a user wants to create, add, set up, or configure GitHub Actions, CI/CD, automated checks, or deployment workflows for an EmDash…

EngDawood/emdash-claude-plugin · 234 tokens

adversarial-reviewer

Stress-test a code change for concrete correctness defects, unsafe assumptions, and failure modes. Use when the user explicitly asks for an adversarial review, a deep bug hunt, or to tear a change apart. Do not use for ordinary review, style feedback, or general improvement suggestions.

EngDawood/emdash-claude-plugin · 62 tokens