Agent skill

Markedit Tools

by sammcj in sammcj/agentic-coding

Provides tools for managing MarkEdit, a macOS markdown editor

Apache-2.0Auto-check passed

Install Markedit Tools

skills CLI
$ npx skills add sammcj/agentic-coding --skill markedit-tools -a claude-code

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

GitHub CLI
$ gh skill install sammcj/agentic-coding markedit-tools --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/sammcj/agentic-coding.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Skills_disabled/markedit .claude/skills/markedit-tools && 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
markedit-tools
GitHub stars
162
Token cost
~1.4k tokens
SKILL.md length
548 words
Files
1
Skills in repo
62
Repo updated
First seen
Licence
Apache-2.0

At a glance

Provides tools for managing MarkEdit, a macOS markdown editor

  • Works in 3 steps: Fetch the latest release tag from the… → Read the tag_name field from the response. → Download the asset using
  • SKILL.md covers Key Capabilities, Core Concepts, Common Tasks and Examples, plus 3 more sections
  • Calls osascript; reaches github.com and api.github.com

What it does

Markedit Tools is an agent skill from sammcj/agentic-coding. Provides tools for managing MarkEdit, a macOS markdown editor

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with macOS and GitHub. The repository describes itself as: Agentic Coding Rules, Templates etc... The licence is Apache-2.0.

Example prompts

  • “Use the markedit-tools skill to provide tools for managing MarkEdit, a macOS markdown editor”
  • “/markedit-tools”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Fetch the latest release tag from the GitHub API
  2. Read the tag_name field from the response.
  3. Download the asset using

What it can do on your machine

Read from SKILL.md and the folder at commit 62ba5a2. 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

    Shell commands in SKILL.md call:

    • osascript

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com
    • api.github.com

    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

Markedit Tools loads about 1.4k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 548 words of instructions outside code blocks.

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

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 sammcj/agentic-coding at commit 62ba5a2, republished under its Apache-2.0 licence (© sammcj). 548 words, ~1,403 tokens.

Download SKILL.mdSave it as .claude/skills/markedit-tools/SKILL.md (or your agent's skills folder).
name
markedit-tools
description
Provides tools for managing MarkEdit, a macOS markdown editor

Purpose

Help users configure and extend MarkEdit, a free and open-source markdown editor for macOS.

Key Capabilities

  • Upgrade the MarkEdit app
  • Install, upgrade, and manage MarkEdit extensions
  • Configure MarkEdit advanced settings
  • Answer questions related to MarkEdit

Core Concepts

File Locations
PathDescription
~/Library/Containers/app.cyan.markedit/Data/Documents/scripts/Extensions directory
~/Library/Containers/app.cyan.markedit/Data/Documents/settings.jsonAdvanced settings
~/Library/Containers/app.cyan.markedit/Data/Documents/editor.cssCustom stylesheets
~/Library/Containers/app.cyan.markedit/Data/Documents/editor.jsCustom JavaScript
Extension URLs

When a user provides an extension name, download from this URL pattern:

https://github.com/MarkEdit-app/extension-name/blob/main/dist/extension-name-kebab-cased.js?raw=true

Always normalise the extension name to kebab-case.

For example, MarkEdit Preview is available at: https://github.com/MarkEdit-app/MarkEdit-preview/blob/main/dist/markedit-preview.js?raw=true

When a user requests a "lite" build, it is located in the lite subfolder under dist: https://github.com/MarkEdit-app/MarkEdit-preview/blob/main/dist/lite/markedit-preview.js?raw=true

The filename is identical to the standard build; do not add a -lite suffix.

If the dist file is not found (non-200 response), fall back to the GitHub latest release asset:

  1. Fetch the latest release tag from the GitHub API: https://api.github.com/repos/MarkEdit-app/extension-name/releases/latest
  2. Read the tag_name field from the response.
  3. Download the asset using:
https://github.com/MarkEdit-app/extension-name/releases/download/{tag_name}/extension-name-kebab-cased.js

For example, if dist/markedit-preview.js is not available in the repository and the latest release tag is v1.0.0: https://github.com/MarkEdit-app/MarkEdit-preview/releases/download/v1.0.0/markedit-preview.js

If the user provides a URL ending with .js, use that URL directly.

Common Tasks

Upgrading MarkEdit
  1. Retrieve the latest release from GitHub releases
  2. Prompt the user to choose: .dmg or apple-silicon.dmg
  3. Download the selected installer
  4. Extract the .app bundle from the .dmg
  5. Move the .app bundle to /Applications
  6. Launch MarkEdit
Re-Launching MarkEdit
sh
osascript -e 'quit app "MarkEdit"' -e 'delay 1' -e 'launch app "MarkEdit"'
Installing Extensions
  1. Download the extension by name or URL
  2. Place it in the extensions directory
  3. Re-launch MarkEdit

Use the filename derived from the URL. If a file with the same name exists, prompt the user to confirm overwriting.

Listing Extensions

List all .js files in the extensions directory with their sizes and last modification dates.

Upgrading Extensions
  1. Re-download the extension from the same source (lite or full)
  2. Overwrite the existing file
  3. Re-launch MarkEdit
Uninstalling Extensions
  1. Add .js suffix to the name if needed
  2. Remove the file from the extensions directory
  3. Re-launch MarkEdit
Show full SKILL.md (215 more words)Show less
Editing Preferences
  1. Use the wiki as reference
  2. Edit settings.json directly
  3. Re-launch MarkEdit
Answering Questions

When users ask questions:

  1. If it's a task (install, configure, upgrade) → perform the action
  2. If it's a customisation question → explain editor.css, editor.js, or settings.json
  3. If it's a feature question → fetch from wiki and issues
  4. If unknown → suggest the wiki or GitHub issues

Examples

  • "Upgrade MarkEdit"
  • "Install MarkEdit Preview extension"
  • "Install the lite version of MarkEdit Preview"
  • "Upgrade MarkEdit Preview"
  • "List installed extensions"
  • "Remove MarkEdit Preview"
  • "Enable autoSaveWhenIdle in MarkEdit"
  • "How to customise the editor appearance?"

Error Handling

  • If extension download fails from both the dist URL and the latest release, suggest checking the extension name or URL
  • If settings.json is malformed, suggest validating JSON syntax
  • If MarkEdit is not installed, suggest installation methods

Documentation

When answering questions, refer to the MarkEdit Wiki:

Search also https://github.com/MarkEdit-app/MarkEdit/issues?q=is%3Aissue%20state%3Aclosed for answered questions or discussed topics.

When answering questions related to development, refer to the MarkEdit API repository too.


Chezmoi

The user manages their markedit config files with chezmoi.

After making changes to settings.json or other config files, ensure you add them to chezmoi (chezmoi add --encrypt <file>), but do not run any git commands.

© sammcj, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in Skills_disabled/markedit of sammcj/agentic-coding.

Open the folder on GitHubat commit 62ba5a2

Compare with similar skills

Markedit Tools 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.

Markedit Tools compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Markedit Tools this skillsammcj/agentic-coding162—~1.4kAutomated safety check: PassApache-2.0
Mole CLI Release Flowtw93/Mole70k—~2.5kAutomated safety check: PassGPL-3.0
Release Easydicttisfeng/Easydict15k—~810Automated safety check: PassGPL-3.0
Releaseeugene1g/agent-safehouse2.1k—~3.5kAutomated safety check: PassApache-2.0
Cherry Studio Regression TestsCherryHQ/cherry-studio52k—~1.2kAutomated safety check: PassAGPL-3.0
Kane CLI Browser TestingLambdaTest/kane-cli247—~8.4kAutomated safety check: PassApache-2.0

Similar skills

  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Release Easydict

    tisfeng/Easydict

    编排 Easydict macOS 的 draft、publish、release 和 resume,整理英文 GitHub Release 内容,并处理发布后的 Issue 跟进及本地清理。不用于一般的发布流程设计讨论。

    15k GitHub stars~810 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Release

    eugene1g/agent-safehouse

    Run the local Agent Safehouse release flow: inspect commits since the last published release, propose the next SemVer version and changelog, present a dry-run for confirmation, then update…

    2.1k GitHub stars~3.5k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Cherry Studio Regression Tests

    CherryHQ/cherry-studio

    Runs Cherry Studio's critical-path regression suite as deterministic Playwright E2E tests through a GitHub workflow on macOS and Windows runners.

    52k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed
  • Kane CLI Browser Testing

    LambdaTest/kane-cli

    Drives a real browser through the kane-cli tool and designs requirement-linked test suites from a PRD or a plain description, with mobile and cloud-grid runs.

    247 GitHub stars~8.4k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Release

    notepadqq/notepadqq

    Release a new Notepadqq version. An agent skill from notepadqq/notepadqq.

    2.3k GitHub stars~2k tokensUpdated 2 days ago
    MobileAuto-check passed

More from sammcj/agentic-coding

All 62 skills in this repo
  • Yue2 Music

    sammcj/agentic-coding

    A skill your agent uses when generating songs with YuE2, covering a recording via SheetSage2 audio-to-ABC, editing a score or lyrics with melody preservation, or building a reproducible listening…

    162 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Bento Slides

    sammcj/agentic-coding

    A skill your agent uses when creating or editing Bento (.bento.html) slide decks, including any request for a single-file HTML slide deck.

    162 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Idrive Backup

    sammcj/agentic-coding

    A skill your agent uses whenever the user wants you to manage, discuss or diagnose iDrive Backup configuration on macOS

    162 GitHub stars~1.7k tokensUpdated today
    Auto-check: notes
  • Piper Tts Training

    sammcj/agentic-coding

    Train custom TTS voices for Piper (ONNX format) using fine-tuning or from-scratch approaches.

    162 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • PPTX To Md

    sammcj/agentic-coding

    Convert a PPTX slide deck into per-slide markdown that preserves both the verbatim text and the meaning of embedded screenshots, diagrams and charts in their original layout positions.

    162 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Skill Creator Primer

    sammcj/agentic-coding

    You MUST load this skill before the skill-creator skill AND before making ANY change to, or conducting a review of ANY Agent Skill.

    162 GitHub stars~9.8k tokensUpdated today
    Auto-check passed

Works with

Questions about Markedit Tools

What does Markedit Tools do?

Provides tools for managing MarkEdit, a macOS markdown editor. Markedit Tools is an agent skill from sammcj/agentic-coding.

How do I install Markedit Tools in Claude Code?

Run `npx skills add sammcj/agentic-coding --skill markedit-tools -a claude-code`. Or copy the skill folder (Skills_disabled/markedit in sammcj/agentic-coding) into .claude/skills/markedit-tools in your project. Claude Code loads it when a task matches its description.

How do I install Markedit Tools in Codex?

Run `npx skills add sammcj/agentic-coding --skill markedit-tools -a codex`. Or copy the skill folder (Skills_disabled/markedit in sammcj/agentic-coding) into .agents/skills/markedit-tools in your project. Codex loads it when a task matches its description.

Can I use Markedit Tools 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 sammcj/agentic-coding --skill markedit-tools -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/markedit-tools, .gemini/skills/markedit-tools, .github/skills/markedit-tools and .opencode/skills/markedit-tools in your project.

What does Markedit Tools need to run?

Going by SKILL.md and its folder, Markedit Tools needs the command-line tools its instructions call (osascript).

Does Markedit Tools access the network?

SKILL.md names 2 domains. In commands or code: github.com and api.github.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Markedit Tools 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 Markedit Tools use?

Markedit Tools is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Markedit Tools use?

About 1.4k tokens (SKILL.md is roughly 5.6k 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 Markedit Tools?

Skills that share tags, products or a category with Markedit Tools: Mole CLI Release Flow (tw93/Mole, 70k stars), Release Easydict (tisfeng/Easydict, 15k stars), Release (eugene1g/agent-safehouse, 2.1k stars) and Cherry Studio Regression Tests (CherryHQ/cherry-studio, 52k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Markedit Tools?

sammcj (a GitHub user) maintains it in sammcj/agentic-coding, which has 162 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on October 7, 2026.

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