improve-skill SKILL.md skillA

improve-skill from devskale/skale-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add devskale/skale-skills/improve-skill@git:20261006.3723cb2

Pins git:20261006.3723cb2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
devskale/skale-skills
Path
deprecated/improve-skill/SKILL.md
Versions recorded
1
Latest version
git:20261006.3723cb2, committed Oct 6, 2026
Size
6,299 bytes
Repository stars
3
License
none declared

Analyze coding agent session transcripts to improve existing skills or create new ones. Use when asked to improve a skill based on a session, or extract a new skill from session history.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Improve Skill

This skill helps analyze coding agent sessions to improve or create skills. It works with Claude Code, Pi, Codex, and OpenCode session files.

## Quick Start

Extract the current session and generate an improvement prompt:

```bash
# Auto-detect agent and extract current session
./scripts/extract-session.js
```

## Session Extraction

The `extract-session.js` script finds and parses session files from any of the four agents:

```bash
# Auto-detect (uses most recent session for current working directory)
./scripts/extract-session.js

# Specify agent type
./scripts/extract-session.js --agent claude
./scripts/extract-session.js --agent pi
./scripts/extract-session.js --agent codex
./scripts/extract-session.js --agent opencode

# Specify a different working directory
./scripts/extract-session.js --cwd /path/to/project

# Use a specific session file
./scripts/extract-session.js /path/to/session.jsonl
```

**Session file locations:**

- **Claude Code**: `~/.claude/projects/<encoded-cwd>/*.jsonl`
- **Pi**: `~/.pi/agent/sessions/<encoded-cwd>/*.jsonl`
- **Codex**: `~/.codex/sessions/YYYY/MM/DD/*.jsonl`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add devskale/skale-skills/improve-skill@sha256:d7377e3b300561c6

The line at the top of this page pins the label git:20261006.3723cb2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2vz3wrstygkz2sic.svg)](https://markdownregistry.com/a/art_2vz3wrstygkz2sic)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 6, 2026.

versioncommittedcommitsizeaudit
git:20261006.3723cb2 latest2026-10-06 3723cb2 6,299 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6299 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

devskale/skale-skills · 3 stars · license none declared · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2vz3wrstygkz2sic
GET https://markdownregistry.com/api/v1/resolve?ref=devskale/skale-skills/improve-skill
GET https://markdownregistry.com/api/v1/blob/d7377e3b300561c61abd6d4151c103c05a5f1d41a98fab3bbf4435ecae1f30d7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from devskale/skale-skills

AGENTS.md AGENTS.md file
devskale/skale-skills · AGENTS.md
git:20261017.899aead · audit A · 3 stars
agent-skill-creator SKILL.md skill
devskale/skale-skills · deprecated/agent-skill-creator/SKILL.md · Guide for creating effective skills for any AI agent (Claude, Trae, Gemini, OpenCode, Qwen, etc.). This skill should be…
git:20261006.3723cb2 · audit A · 3 stars
agents-md-init SKILL.md skill
devskale/skale-skills · deprecated/agents-md-init/SKILL.md · Create and update concise AGENTS.md files using proven best practices. Use when starting a new AGENTS.md, refactoring…
git:20261006.3723cb2 · audit A · 3 stars
command-creator SKILL.md skill
devskale/skale-skills · deprecated/command-creator/SKILL.md · Create custom commands for Pi (prompt templates) or OpenCode. Define command prompts, arguments, shell output…
v2.0.0 · audit A · 3 stars
readme-write SKILL.md skill
devskale/skale-skills · deprecated/readme-write/SKILL.md · Create and update README.md files with proper structure, badges, and sections.
git:20261006.3723cb2 · audit A · 3 stars
todo SKILL.md skill
devskale/skale-skills · deprecated/todo/SKILL.md · Create and manage TODO.md task tracking files for complex multi-step work. Use when starting a larger task that…
git:20261006.3723cb2 · audit A · 3 stars
viewimg SKILL.md skill
devskale/skale-skills · deprecated/viewimg/SKILL.md · DEPRECATED — use `read img.jpg` or `read_image` instead. Display an image in the terminal (view-only, no VLM). Renders…
v0.1.0 · audit A · 3 stars
d2 SKILL.md skill
devskale/skale-skills · skills/d2/SKILL.md · Draw architecture, sequence, flowchart, or ER diagrams as code with the D2 CLI. Use when the user wants to create…
v1.4.1 · audit A · 3 stars
fetch-url SKILL.md skill
devskale/skale-skills · skills/fetch-url/SKILL.md · Bash skill — run `fetch-url "url"` in your shell (not an MCP tool). Fetch and extract readable text from any web page…
v2.9.0 · audit A · 3 stars
figure SKILL.md skill
devskale/skale-skills · skills/figure/SKILL.md · Draw hand-drawn-style architecture or workflow figures (sketchy Excalidraw look) as SVG + PNG from a small .fig.mjs…
v1.2.1 · audit A · 3 stars
improve-ux SKILL.md skill
devskale/skale-skills · skills/improve-ux/SKILL.md · Improve UI/UX grounded in curated reference sites, with a ratings loop and findings ledger. Use when polishing a…
v0.4.0 · audit A · 3 stars
issues SKILL.md skill
devskale/skale-skills · skills/issues/SKILL.md · Manage the cross-machine shared issue kanban (works/<project>/issues/). Create, triage, start, review, cancel, archive…
v1.5.1 · audit A · 3 stars

Every file in devskale/skale-skills

Other files named improve-skill

improve-skill SKILL.md skill
av/skills · improve-skill/SKILL.md · Improve an existing agent SKILL.md through one gated cycle: select the target (default this skill), snapshot the…
git:20260813.b71baeb · audit A · 24 stars
improve-skill SKILL.md skill
namedtoaster/the-last-mile · skills/improve-skill/SKILL.md · Fix a Last Mile skill that did the wrong thing, from inside the project where it went wrong. Decides whether the lesson…
git:20261012.0a65810 · audit A · 14 stars
improve-skill SKILL.md skill
tomzx/agents · skills/improve-skill/SKILL.md · Inspect a single skill in the library, reason about high-value low-risk improvements, and apply them directly. Used by…
git:20261007.b35fc4b · audit A · 12 stars
improve-skill SKILL.md skill
mgiovani/cc-arsenal · skills/improve-skill/SKILL.md · Improve one or more EXISTING agent skills to the current authoring standard, with measured before/after evidence…
v1.0.0 · audit A · 8 stars

Browse by kind, by grade A, or by owner.