Agent skill

Refactor Learning Path Editorial

by ArmDeveloperEcosystem in ArmDeveloperEcosystem/arm-learning-paths

Audit and refactor an existing Arm Learning Path for editorial structure, front matter, discoverability, writing style, accessibility, images, links, Markdown presentation, and code-sample…

Custom licenceAuto-check passedEducation

Install Refactor Learning Path Editorial

skills CLI
$ npx skills add ArmDeveloperEcosystem/arm-learning-paths --skill refactor-learning-path-editorial -a claude-code

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

GitHub CLI
$ gh skill install ArmDeveloperEcosystem/arm-learning-paths refactor-learning-path-editorial --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/ArmDeveloperEcosystem/arm-learning-paths.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/refactor-learning-path-editorial .claude/skills/refactor-learning-path-editorial && 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
refactor-learning-path-editorial
GitHub stars
154
Token cost
~2k tokens
SKILL.md length
872 words
Files
4 (incl. scripts, references)
Skills in repo
15
Repo updated
First seen
Licence
Custom licence

At a glance

Audit and refactor an existing Arm Learning Path for editorial structure, front matter, discoverability, writing style, accessibility, images, links, Markdown presentation, and code-sample…

  • Works in 5 steps: Establish scope and baseline → Run independent editorial reviews → Build the findings ledger → …
  • Modernizing older content under content/learning-paths
  • SKILL.md covers Prerequisites, Editorial boundary, Workflow and Final response, plus 1 more section
  • Runs Python scripts from its folder; calls python3 and git

What it does

Refactor Learning Path Editorial is an agent skill from ArmDeveloperEcosystem/arm-learning-paths. Audit and refactor an existing Arm Learning Path for editorial structure, front matter, discoverability, writing style, accessibility, images, links, Markdown presentation, and code-sample presentation without changing technical instructions. Use when modernizing older content under content/learning-paths, applying multiple editorial skills as one controlled workflow, or requesting an editorial-only Learning Path cleanup with review and verification gates.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/finding-contract.md` and `scripts/editorial_guard.py`).

It sits in Education, covering Curriculum and course design, Refactoring and Markdown. The repository describes itself as: Arm Learning Paths: a repository of how-to content for software developers.

When your agent uses it

  • Modernizing older content under content/learning-paths
  • Applying multiple editorial skills as one controlled workflow
  • Requesting an editorial-only Learning Path cleanup with review and verification gates

Example prompts

  • “/refactor-learning-path-editorial”

Requirements

  • Python 3

Workflow steps

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

  1. Establish scope and baseline
  2. Run independent editorial reviews
  3. Build the findings ledger
  4. Apply accepted fixes sequentially
  5. Verify independently

What it can do on your machine

Read from SKILL.md and the folder at commit 3fb6797. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Refactor Learning Path Editorial loads about 2k tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 123 tokens; SKILL.md has 872 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~123
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

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); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 872 words (~1,966 tokens).

“Refactor one Learning Path through independent review, a deduplicated findings ledger, sequential edits, and a cold verification pass. Preserve technical truth and defer technical review.”

— opening of SKILL.md by ArmDeveloperEcosystem, Custom licence
name
refactor-learning-path-editorial

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts, references) in .github/skills/refactor-learning-path-editorial of ArmDeveloperEcosystem/arm-learning-paths.

  • SKILL.md
  • agents/openai.yaml
  • references/finding-contract.md
  • scripts/editorial_guard.py

Open the folder on GitHubat commit 3fb6797

Compare with similar skills

Refactor Learning Path Editorial 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.

Refactor Learning Path Editorial compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Refactor Learning Path Editorial this skillArmDeveloperEcosystem/arm-learning-paths154—~2kAutomated safety check: PassCustom licence
Reading Guidechingswy/Skill-Research-Figure178—~4.5kAutomated safety check: PassNone
AI Engineering Placement Quizrohitg00/ai-engineering-from-scratch65k—~2kAutomated safety check: PassMIT
K-12 Core Literacy Lesson DesignTHU-MAIC/OpenMAIC40k—~2.4kAutomated safety check: PassMIT
AnythingAtlasLiuziyu77/AnythingAtlas195—~3.6kAutomated safety check: PassApache-2.0
Codex Skill Self-AssessmentFlorianBruniaux/claude-code-ultimate-guide6.1k—~2.3kAutomated safety check: PassCC-BY-SA-4.0

Similar skills

  • Reading Guide

    chingswy/Skill-Research-Figure

    Structured learning navigator for blog posts and articles. An agent skill from chingswy/Skill-Research-Figure.

    178 GitHub stars~4.5k tokensUpdated 26 days ago
    Writing & ContentAuto-check passed
  • AI Engineering Placement Quiz

    rohitg00/ai-engineering-from-scratch

    Runs a 10-question quiz across five areas to place a learner in the AI Engineering from Scratch curriculum, so they skip what they already know.

    65k GitHub stars~2k tokensUpdated today
    EducationAuto-check passed
  • Designs a Chinese K-12 classroom for one OpenMAIC stage around the core-literacy model, using authentic tasks, performance assessment and observable evidence.

    40k GitHub stars~2.4k tokensUpdated today
    EducationAuto-check passed
  • AnythingAtlas

    Liuziyu77/AnythingAtlas

    Researches an unfamiliar topic and delivers a verified resource guide and a staged, timed learning roadmap as matching Markdown and HTML files.

    195 GitHub stars~3.6k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Codex Skill Self-Assessment

    FlorianBruniaux/claude-code-ultimate-guide

    Runs an interactive quiz in a quick or comprehensive mode, scores your skill level by topic and generates a personalized learning path with practice projects.

    6.1k GitHub stars~2.3k tokensUpdated today
    EducationAuto-check passed
  • Curriculum Planner

    THU-MAIC/OpenMAIC

    Plans a multi-classroom series such as a seven-day course, clarifies the brief in rounds, gets sign-off on the full lesson list, then builds each stage in a shared folder.

    40k GitHub stars~2.8k tokensUpdated today
    EducationAuto-check passed

More from ArmDeveloperEcosystem/arm-learning-paths

All 15 skills in this repo
  • Audit Images

    ArmDeveloperEcosystem/arm-learning-paths

    Audit and fix Markdown image alt text in Arm Learning Paths and install guides.

    154 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Stale Content Review

    ArmDeveloperEcosystem/arm-learning-paths

    Scan Arm Learning Paths and install guides for stale-content risk.

    154 GitHub stars~991 tokensUpdated today
    Auto-check passed
  • Draft Learning Path

    ArmDeveloperEcosystem/arm-learning-paths

    Toggle draft mode on a Learning Path index.md. An agent skill from ArmDeveloperEcosystem/arm-learning-paths.

    154 GitHub stars~658 tokensUpdated today
    Auto-check passed
  • Install Guide Structure Review

    ArmDeveloperEcosystem/arm-learning-paths

    Review Arm install guides for structural soundness, installation-only scope, verification quality, OS-specific sections, troubleshooting, multi-page guide behavior, and version-note placement.

    154 GitHub stars~780 tokensUpdated today
    Auto-check passed
  • Link Text Review

    ArmDeveloperEcosystem/arm-learning-paths

    Review and improve accessible Markdown link text in Arm Learning Paths and install guides.

    154 GitHub stars~692 tokensUpdated today
    Auto-check passed
  • Metadata Description Update

    ArmDeveloperEcosystem/arm-learning-paths

    Add or improve SEO-friendly front matter description fields for Arm Learning Paths and install guides.

    154 GitHub stars~970 tokensUpdated today
    Auto-check passed

Categories

Questions about Refactor Learning Path Editorial

What does Refactor Learning Path Editorial do?

Audit and refactor an existing Arm Learning Path for editorial structure, front matter, discoverability, writing style, accessibility, images, links, Markdown presentation, and code-sample…. Refactor Learning Path Editorial is an agent skill from ArmDeveloperEcosystem/arm-learning-paths. Audit and refactor an existing Arm Learning Path for editorial structure, front matter, discoverability, writing style, accessibility, images, links, Markdown presentation, and code-sample presentation without changing technical instructions.

When should I use Refactor Learning Path Editorial?

Refactor Learning Path Editorial fits situations like: modernizing older content under content/learning-paths; applying multiple editorial skills as one controlled workflow; requesting an editorial-only Learning Path cleanup with review and verification gates.

How do I install Refactor Learning Path Editorial in Claude Code?

Run `npx skills add ArmDeveloperEcosystem/arm-learning-paths --skill refactor-learning-path-editorial -a claude-code`. Or copy the skill folder (.github/skills/refactor-learning-path-editorial in ArmDeveloperEcosystem/arm-learning-paths) into .claude/skills/refactor-learning-path-editorial in your project. Claude Code loads it when a task matches its description.

How do I install Refactor Learning Path Editorial in Codex?

Run `npx skills add ArmDeveloperEcosystem/arm-learning-paths --skill refactor-learning-path-editorial -a codex`. Or copy the skill folder (.github/skills/refactor-learning-path-editorial in ArmDeveloperEcosystem/arm-learning-paths) into .agents/skills/refactor-learning-path-editorial in your project. Codex loads it when a task matches its description.

Can I use Refactor Learning Path Editorial 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 ArmDeveloperEcosystem/arm-learning-paths --skill refactor-learning-path-editorial -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/refactor-learning-path-editorial, .gemini/skills/refactor-learning-path-editorial, .github/skills/refactor-learning-path-editorial and .opencode/skills/refactor-learning-path-editorial in your project.

What does Refactor Learning Path Editorial need to run?

Going by SKILL.md and its folder, Refactor Learning Path Editorial needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and git). Our summary lists: Python 3.

Does Refactor Learning Path Editorial access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Refactor Learning Path Editorial 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Refactor Learning Path Editorial use?

Refactor Learning Path Editorial has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Refactor Learning Path Editorial use?

About 2k tokens (SKILL.md is roughly 7.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 516 tokens, read only when the agent opens those files.

What are the alternatives to Refactor Learning Path Editorial?

Skills that share tags, products or a category with Refactor Learning Path Editorial: Reading Guide (chingswy/Skill-Research-Figure, 178 stars), AI Engineering Placement Quiz (rohitg00/ai-engineering-from-scratch, 65k stars), K-12 Core Literacy Lesson Design (THU-MAIC/OpenMAIC, 40k stars) and AnythingAtlas (Liuziyu77/AnythingAtlas, 195 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Refactor Learning Path Editorial?

ArmDeveloperEcosystem (a GitHub organization) maintains it in ArmDeveloperEcosystem/arm-learning-paths, which has 154 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.

Source: ArmDeveloperEcosystem/arm-learning-paths on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.