Agent skill

Evolve Kanban Md Formats

by antopolskiy in antopolskiy/kanban-md

Evolve kanban-md config.yml schemas and task Markdown frontmatter without breaking existing boards.

MITAuto-check passedProductivity & Automation

Install Evolve Kanban Md Formats

skills CLI
$ npx skills add antopolskiy/kanban-md --skill evolve-kanban-md-formats -a claude-code

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

GitHub CLI
$ gh skill install antopolskiy/kanban-md evolve-kanban-md-formats --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/antopolskiy/kanban-md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/evolve-kanban-md-formats .claude/skills/evolve-kanban-md-formats && 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
evolve-kanban-md-formats
GitHub stars
223
Token cost
~795 tokens
SKILL.md length
343 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Evolve kanban-md config.yml schemas and task Markdown frontmatter without breaking existing boards.

  • Works in 6 steps: Inspect internal/config/defaults.go,… → Increment CurrentVersion in… → Add a migration from the previous… → …
  • Changing config fields
  • SKILL.md covers Configuration design, Config schema changes, Task frontmatter changes and Verification
  • Calls go

What it does

Evolve Kanban Md Formats is an agent skill from antopolskiy/kanban-md. Evolve kanban-md config.yml schemas and task Markdown frontmatter without breaking existing boards. Use when changing config fields, defaults, migrations, CurrentVersion, YAML tags, task metadata, or compatibility fixtures. Do not use for CLI output-only changes or ordinary task data edits.

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

It sits in Productivity & Automation, covering Task management. The repository describes itself as: File-based kanban board for autonomous agentic loop. CLI and TUI for multi-agent workflows. Skills included. The licence is MIT.

When your agent uses it

  • Changing config fields
  • Compatibility fixtures
  • CLI output-only changes
  • Ordinary task data edits

Example prompts

  • “/evolve-kanban-md-formats”

Requirements

  • Pre-approved tools (allowed-tools): Bash(go test *), Bash(golangci-lint *), Bash(git diff *)

Workflow steps

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

  1. Inspect internal/config/defaults.go, internal/config/migrate.go, and every
  2. Increment CurrentVersion in internal/config/defaults.go.
  3. Add a migration from the previous version in internal/config/migrate.go,
  4. Create internal/config/testdata/compat/vN/, where N is the old version.
  5. Add or extend internal/config/compat_test.go assertions so the old fixture
  6. Update the generated-config example and user guidance when the serialized

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(go test *)
    • Bash(golangci-lint *)
    • Bash(git diff *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go

    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

Evolve Kanban Md Formats loads about 795 tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 343 words of instructions outside code blocks.

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

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 antopolskiy/kanban-md at commit e3816f2, republished under its MIT licence (© antopolskiy). 343 words, ~795 tokens.

Download SKILL.mdSave it as .claude/skills/evolve-kanban-md-formats/SKILL.md (or your agent's skills folder).
name
evolve-kanban-md-formats
description
Evolve kanban-md config.yml schemas and task Markdown frontmatter without breaking existing boards. Use when changing config fields, defaults, migrations, CurrentVersion, YAML tags, task metadata, or compatibility fixtures. Do not use for CLI output-only changes or ordinary task data edits.
allowed-tools
Bash(go test *), Bash(golangci-lint *), Bash(git diff *)

Evolve kanban-md formats

Treat config.yml and task frontmatter as durable user data contracts. Existing boards must remain readable after an upgrade, and migrations must be explicit, ordered, and covered by compatibility fixtures.

Configuration design

  • Collocate new or migrated per-column settings with the corresponding entry in statuses. This applies to settings such as show_duration, require_claim, and WIP limits.
  • The existing top-level wip_limits map is a compatibility shape, not a model for new per-column settings. Migrate it only as part of an intentional schema revision.
  • Prefer backward-compatible defaults and prospective enforcement. Do not make an existing board invalid merely because a new optional policy exists.

Config schema changes

  1. Inspect internal/config/defaults.go, internal/config/migrate.go, and every existing compatibility fixture before editing the schema.
  2. Increment CurrentVersion in internal/config/defaults.go.
  3. Add a migration from the previous version in internal/config/migrate.go, register it in the migrations map, and increment cfg.Version in the migration.
  4. Create internal/config/testdata/compat/vN/, where N is the old version. Start from the previous fixture and make it representative of the format being migrated, including sample task files when relevant.
  5. Add or extend internal/config/compat_test.go assertions so the old fixture loads through all migrations and exposes the intended current values.
  6. Update the generated-config example and user guidance when the serialized shape or defaults change.

Never skip intermediate versions or mutate an old fixture to look like the new format; fixtures document what users already have on disk.

Task frontmatter changes

  • Additive optional fields with omitempty preserve old files that omit them, but still require a fixture and parsing assertion for the new field.
  • Do not rename or remove an existing YAML tag. If semantics must evolve, keep reading the old representation and migrate or translate it explicitly.
  • Exercise new task fields in internal/task/testdata/compat/v1/tasks/, or create a new versioned fixture directory when the task format itself becomes versioned or requires migration.
  • Add assertions in internal/task/compat_test.go for parsing, zero values, and round-trip behavior where relevant.

Verification

Run every historical compatibility fixture, not only the new one:

bash
go test -run Compat ./internal/config/ ./internal/task/
go test ./internal/config/ ./internal/task/

Then follow test-kanban-md for repository-wide verification and inspect the serialized fixture/config diffs manually.

© antopolskiy, MIT. 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 .agents/skills/evolve-kanban-md-formats of antopolskiy/kanban-md.

Open the folder on GitHubat commit e3816f2

Compare with similar skills

Evolve Kanban Md Formats 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.

Evolve Kanban Md Formats compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Evolve Kanban Md Formats this skillantopolskiy/kanban-md223—~795Automated safety check: PassMIT
Superset Agent Standupsuperset-sh/superset15k—~712Automated safety check: PassCustom licence
AgentRQ Workspace Agentagentrq/agentrq1.1k—~1.9kAutomated safety check: PassAGPL-3.0
Markdown Task Managerioniks/MarkdownTaskManager535—~2.2kAutomated safety check: PassMPL-2.0
Pi Messenger Crewnicobailon/pi-messenger719—~3.7kAutomated safety check: PassNone
Codekanban CLIfy0/CodeKanban226—~2.7kAutomated safety check: PassApache-2.0

Similar skills

  • Superset Agent Standup

    superset-sh/superset

    Sweeps every Superset workspace, task and agent terminal to report what finished, what needs review and what is blocked, read-only, and can publish the digest as a page.

    15k GitHub stars~712 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Guides a workspace agent through executing assigned tasks, replying to a remote human operator, and creating sub-tasks, memory and events inside an AgentRQ workspace.

    1.1k GitHub stars~1.9k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Markdown Task Manager

    ioniks/MarkdownTaskManager

    A skill your agent uses when managing tasks, the system is a Kanban task manager based on local Markdown files (kanban.md and archive.md).

    535 GitHub stars~2.2k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check passed
  • Pi Messenger Crew

    nicobailon/pi-messenger

    Orchestrator reference for pi-messenger Crew planning, task management, configuration, and agent coordination.

    719 GitHub stars~3.7k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Codekanban CLI

    fy0/CodeKanban

    Operate CodeKanban workflows, terminal sessions, and web sessions through the installable codekanban-cli command.

    226 GitHub stars~2.7k tokensUpdated 7 days ago
    Productivity & AutomationAuto-check passed
  • Kanban Video Orchestrator

    Luciole-Studio/Misaka-Agent

    Plan and run multi-agent video production pipelines. An agent skill from Luciole-Studio/Misaka-Agent.

    171 GitHub starsUsed in 2 repos~2.4k tokens
    Productivity & AutomationAuto-check: notes

More from antopolskiy/kanban-md

  • Kanban Md

    antopolskiy/kanban-md

    Manage project tasks using kanban-md, a file-based kanban board CLI.

    223 GitHub stars~4k tokensUpdated 5 days ago
    Auto-check passed
  • Release Kanban Md

    antopolskiy/kanban-md

    Release kanban-md through its tag-triggered GoReleaser workflow, monitor CI, recover safely from failures, and publish user-facing GitHub release notes.

    223 GitHub stars~1.2k tokensUpdated 5 days ago
    Auto-check passed
  • Test Kanban Md

    antopolskiy/kanban-md

    Plan and run verification for kanban-md changes, including test-driven bug fixes, Go package tests, CLI end-to-end tests, TUI behavior and snapshots, lint, and precommit checks.

    223 GitHub stars~737 tokensUpdated 5 days ago
    Auto-check passed
  • Kanban Based Development

    antopolskiy/kanban-md

    Autonomous, parallel-safe development workflow using kanban-md.

    223 GitHub stars~2.3k tokensUpdated 5 days ago
    Auto-check passed
  • Design Kanban Md Output

    antopolskiy/kanban-md

    Preserve and evolve kanban-md table, compact, and JSON output contracts.

    223 GitHub stars~767 tokensUpdated 5 days ago
    Auto-check passed
  • Kanban Md Principal Owner

    antopolskiy/kanban-md

    Review kanban-md feature requests, issues, PRs, and design proposals for product fit, domain-model growth, configurability, and compatibility.

    223 GitHub stars~1.7k tokensUpdated 5 days ago
    Auto-check passed

Questions about Evolve Kanban Md Formats

What does Evolve Kanban Md Formats do?

Evolve kanban-md config.yml schemas and task Markdown frontmatter without breaking existing boards. Evolve Kanban Md Formats is an agent skill from antopolskiy/kanban-md.yml schemas and task Markdown frontmatter without breaking existing boards.

When should I use Evolve Kanban Md Formats?

Evolve Kanban Md Formats fits situations like: changing config fields; compatibility fixtures; CLI output-only changes; ordinary task data edits.

How do I install Evolve Kanban Md Formats in Claude Code?

Run `npx skills add antopolskiy/kanban-md --skill evolve-kanban-md-formats -a claude-code`. Or copy the skill folder (.agents/skills/evolve-kanban-md-formats in antopolskiy/kanban-md) into .claude/skills/evolve-kanban-md-formats in your project. Claude Code loads it when a task matches its description.

How do I install Evolve Kanban Md Formats in Codex?

Run `npx skills add antopolskiy/kanban-md --skill evolve-kanban-md-formats -a codex`. Or copy the skill folder (.agents/skills/evolve-kanban-md-formats in antopolskiy/kanban-md) into .agents/skills/evolve-kanban-md-formats in your project. Codex loads it when a task matches its description.

Can I use Evolve Kanban Md Formats 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 antopolskiy/kanban-md --skill evolve-kanban-md-formats -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/evolve-kanban-md-formats, .gemini/skills/evolve-kanban-md-formats, .github/skills/evolve-kanban-md-formats and .opencode/skills/evolve-kanban-md-formats in your project.

What does Evolve Kanban Md Formats need to run?

Going by SKILL.md and its folder, Evolve Kanban Md Formats needs the command-line tools its instructions call (go). Its frontmatter pre-approves these tools: Bash(go test *), Bash(golangci-lint *), Bash(git diff *).

Does Evolve Kanban Md Formats 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 Evolve Kanban Md Formats 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 Evolve Kanban Md Formats use?

Evolve Kanban Md Formats is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Evolve Kanban Md Formats use?

About 795 tokens (SKILL.md is roughly 3.2k 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 Evolve Kanban Md Formats?

Skills that share tags, products or a category with Evolve Kanban Md Formats: Superset Agent Standup (superset-sh/superset, 15k stars), AgentRQ Workspace Agent (agentrq/agentrq, 1.1k stars), Markdown Task Manager (ioniks/MarkdownTaskManager, 535 stars) and Pi Messenger Crew (nicobailon/pi-messenger, 719 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Evolve Kanban Md Formats?

antopolskiy (a GitHub user) maintains it in antopolskiy/kanban-md, which has 223 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 5, 2026.

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