Agent skill

Hk Shift Changelog

by deepklarity in deepklarity/harness-kit

Create and maintain a shift-handover HTML changelog artifact — a page the returning human reads in two minutes to know everything that happened while they were away.

MITAuto-check passedDevelopment

Install Hk Shift Changelog

skills CLI
$ npx skills add deepklarity/harness-kit --skill hk-shift-changelog -a claude-code

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

GitHub CLI
$ gh skill install deepklarity/harness-kit hk-shift-changelog --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/deepklarity/harness-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/hk-shift-changelog .claude/skills/hk-shift-changelog && 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
hk-shift-changelog
GitHub stars
100
Token cost
~867 tokens
SKILL.md length
435 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Create and maintain a shift-handover HTML changelog artifact — a page the returning human reads in two minutes to know everything that happened while they were away.

  • Works in 6 steps: Header — project + "shift handover", a… → TL;DR box — 3-5 sentences: what changed,… → What happened, in order — timeline… → …
  • Working autonomously for an away user
  • SKILL.md covers Where it lives, Structure (top-down by how…, Design rules and Cadence
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hk Shift Changelog is an agent skill from deepklarity/harness-kit. Create and maintain a shift-handover HTML changelog artifact — a page the returning human reads in two minutes to know everything that happened while they were away. Generic across projects. Use when working autonomously for an away user, when asked for a changelog/progress page/catch-up artifact, or at every meaningful transition once one exists. Triggers on - 'changelog artifact', 'progress page', 'what happened while I was away', 'keep me posted in html', or /hk-shift-changelog.

Its SKILL.md is about 870 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 Development, covering Changelog and release notes. The repository describes itself as: A kit for building with AI agents and also the engineering patterns around it. The licence is MIT.

When your agent uses it

  • Working autonomously for an away user
  • Asked for a changelog/progress page/catch-up artifact
  • At every meaningful transition once one exists
  • - changelog artifact

Example prompts

  • “changelog artifact”
  • “progress page”
  • “what happened while I was away”
  • “/hk-shift-changelog”

Workflow steps

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

  1. Header — project + "shift handover", a stamp saying what period it
  2. TL;DR box — 3-5 sentences: what changed, what's running, whether
  3. What happened, in order — timeline entries: a short label (wave
  4. Scoreboard / metrics — whatever the project tracks (bucket scores,
  5. Waiting on you — a numbered list of decisions only the human can
  6. Footer — "living document, rewritten each transition" + where the

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Hk Shift Changelog loads about 867 tokens when it runs. Until then it costs about 126 tokens; SKILL.md has 435 words of instructions outside code blocks.

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

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 deepklarity/harness-kit at commit 87305cd, republished under its MIT licence (© deepklarity). 435 words, ~867 tokens.

Download SKILL.mdSave it as .claude/skills/hk-shift-changelog/SKILL.md (or your agent's skills folder).
name
hk-shift-changelog
description
Create and maintain a shift-handover HTML changelog artifact — a page the returning human reads in two minutes to know everything that happened while they were away. Generic across projects. Use when working autonomously for an away user, when asked for a changelog/progress page/catch-up artifact, or at every meaningful transition once one exists. Triggers on - 'changelog artifact', 'progress page', 'what happened while I was away', 'keep me posted in html', or /hk-shift-changelog.

Shift-handover changelog (project-agnostic)

One living HTML page, rewritten (never appended) at every meaningful transition, redeployed to the SAME artifact URL every time. The reader is a teammate back from sleep or a weekend: they want the state of the world, not a log.

Where it lives

  • File: one stable path in the repo (e.g. docs/<area>/changelog.html), committed, so any future session can find and redeploy it.
  • URL: record the artifact URL in the project's durable operator notes (state/RESUME file) the first time you publish. Every later publish passes that url — never mint a second artifact for the same duty.
  • Favicon: pick one emoji the first time; never change it (users find the tab by icon).

Structure (top-down by how fast the reader wants out)

  1. Header — project + "shift handover", a stamp saying what period it covers (relative, not raw timestamps).
  2. TL;DR box — 3-5 sentences: what changed, what's running, whether anything is blocked on the reader. If they read nothing else, this suffices.
  3. What happened, in order — timeline entries: a short label (wave close / incident / directive / decision), a bold headline, 1-3 sentences, and a status pill (DONE / RUNNING / VERIFIED / WAITING). Every user directive gets its own entry so they can verify they were understood.
  4. Scoreboard / metrics — whatever the project tracks (bucket scores, suites, costs), as a table with movement + evidence, never bare deltas.
  5. Waiting on you — a numbered list of decisions only the human can make. This section earns the page its keep; keep it brutally current.
  6. Footer — "living document, rewritten each transition" + where the ground truth lives.
Show full SKILL.md (174 more words)Show less

Design rules

Load the artifact-design skill before first authoring. Beyond it:

  • Utilitarian treatment: real hierarchy, quiet type, one accent; both themes via CSS tokens (prefers-color-scheme + data-theme overrides).
  • Bind background AND text color to the SAME token set on html, body with !important. The artifact shell may force its own body background; if your ink tokens go dark while its ground stays light, the page is unreadable (seen live). Background and ink must move together or not at all.
  • Self-contained (CSP): no external fonts/scripts; system font stacks.
  • Tables wrapped in overflow-x:auto; digits get tabular-nums.
  • Plain language throughout; no ids or jargon the reader must decode; name things by what they mean, cite ids only as secondary mono detail.

Cadence

Rewrite + redeploy at: phase/wave boundaries, incidents and their fixes, user directives received while away, score/metric movements, and anything that adds to "Waiting on you". Batch small transitions; never let the page drift more than ~30 min behind a meaningful one. Keep the file and the deployed artifact in lockstep — commit the file in the same breath.

© deepklarity, 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 .claude/skills/hk-shift-changelog of deepklarity/harness-kit.

Open the folder on GitHubat commit 87305cd

Compare with similar skills

Hk Shift Changelog 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.

Hk Shift Changelog compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hk Shift Changelog this skilldeepklarity/harness-kit100—~867Automated safety check: PassMIT
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
StarRocks Release NotesStarRocks/starrocks12k—~1.9kAutomated safety check: NotesApache-2.0
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
Rea Changelog Updatemorluto/rea80k—~1.9kAutomated safety check: PassMIT
Mole CLI Release Flowtw93/Mole70k—~2.6kAutomated safety check: PassGPL-3.0

Similar skills

  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • StarRocks Release Notes

    StarRocks/starrocks

    Drafts English release notes for a StarRocks patch release from the PRs merged into its release branch, then opens a documentation PR and hands translation to /translate.

    12k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check: notes
  • Cutting A Release

    TriliumNext/Trilium

    A skill your agent uses when cutting, preparing, or debugging a Trilium release — bumping the monorepo version, tagging, or diagnosing a failed "Release" workflow run.

    38k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Prepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.

    80k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • 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.6k tokensUpdated today
    DevelopmentAuto-check passed
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from deepklarity/harness-kit

All 18 skills in this repo
  • Hk Skill Creator

    deepklarity/harness-kit

    Create new skills, modify and improve existing skills, and measure skill performance.

    100 GitHub stars~3.2k tokensUpdated 2 mo ago
    Auto-check: notes
  • Hk Arch Audit

    deepklarity/harness-kit

    Run comprehensive agent-native architecture review with scored principles.

    100 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check: notes
  • Hk Mock First

    deepklarity/harness-kit

    Mock-first, layer-by-layer feature development. An agent skill from deepklarity/harness-kit.

    100 GitHub stars~3.9k tokensUpdated 2 mo ago
    Auto-check: notes
  • Hk Autonomy Audit

    deepklarity/harness-kit

    Audit whether an AI agent can autonomously close the loop on problems in a given area — from discovering a symptom to verifying a fix — without human intervention.

    100 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check: notes
  • Hk Breadcrumb Creator

    deepklarity/harness-kit

    Traces a workflow end-to-end through the harness-kit monorepo and creates a breadcrumb analysis doc in docs/breadcrumbanalysis/.

    100 GitHub stars~3k tokensUpdated 2 mo ago
    Auto-check: notes
  • Hk Changelog

    deepklarity/harness-kit

    Generate changelog entries from git diffs, prepend to CHANGELOG.md, and optionally commit + PR.

    100 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check: notes

Categories

Questions about Hk Shift Changelog

What does Hk Shift Changelog do?

Create and maintain a shift-handover HTML changelog artifact — a page the returning human reads in two minutes to know everything that happened while they were away. Hk Shift Changelog is an agent skill from deepklarity/harness-kit. Create and maintain a shift-handover HTML changelog artifact — a page the returning human reads in two minutes to know everything that happened while they were away.

When should I use Hk Shift Changelog?

Hk Shift Changelog fits situations like: working autonomously for an away user; asked for a changelog/progress page/catch-up artifact; at every meaningful transition once one exists; - changelog artifact.

How do I install Hk Shift Changelog in Claude Code?

Run `npx skills add deepklarity/harness-kit --skill hk-shift-changelog -a claude-code`. Or copy the skill folder (.claude/skills/hk-shift-changelog in deepklarity/harness-kit) into .claude/skills/hk-shift-changelog in your project. Claude Code loads it when a task matches its description.

How do I install Hk Shift Changelog in Codex?

Run `npx skills add deepklarity/harness-kit --skill hk-shift-changelog -a codex`. Or copy the skill folder (.claude/skills/hk-shift-changelog in deepklarity/harness-kit) into .agents/skills/hk-shift-changelog in your project. Codex loads it when a task matches its description.

Can I use Hk Shift Changelog 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 deepklarity/harness-kit --skill hk-shift-changelog -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hk-shift-changelog, .gemini/skills/hk-shift-changelog, .github/skills/hk-shift-changelog and .opencode/skills/hk-shift-changelog in your project.

What does Hk Shift Changelog need to run?

SKILL.md names no scripts, command-line tools or credentials: Hk Shift Changelog is instructions for the agent only.

Does Hk Shift Changelog 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 Hk Shift Changelog 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 Hk Shift Changelog use?

Hk Shift Changelog 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 Hk Shift Changelog use?

About 867 tokens (SKILL.md is roughly 3.5k 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 Hk Shift Changelog?

Skills that share tags, products or a category with Hk Shift Changelog: Simple English (moeru-ai/airi, 50k stars), StarRocks Release Notes (StarRocks/starrocks, 12k stars), Cutting A Release (TriliumNext/Trilium, 38k stars) and Rea Changelog Update (morluto/rea, 80k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hk Shift Changelog?

deepklarity (a GitHub organization) maintains it in deepklarity/harness-kit, which has 100 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on July 15, 2026.

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