One-click install
npx skills add https://github.com/juxt/claude-plugins --skill chalk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chalk
Source: https://github.com/juxt/claude-plugins/tree/main/plugins/chalk/skills/chalk
Command: npx skills add https://github.com/juxt/claude-plugins --skill chalk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When working on GitHub issues, code diffs fail to capture the reasoning behind changes, and unstructured comments make it hard for team members to understand the full context of work done. Issue descriptions often fall out of sync with actual progress, leading to duplicated effort and missed context when resuming work later.

Core Features & Use Cases

  • Structured Session Comments: Automatically format work logs with scannable checklists and detailed explanation blocks for each task, so anyone can review what was tried, decided, and learned without sifting through chat history.
  • Canonical Progress Tracking: Maintains an up-to-date ## Progress section in the issue description with a checklist of work items and status, so the issue itself always reflects the current state of work.
  • Consistent Issue Voice: Enforces a standardized "chalk voice" for all GitHub-bound prose (issues, comments, PR descriptions) to ensure reasoning is clearly communicated to readers.
  • Use Case: When fixing a bug reported in issue #456, use this skill to log each step of your investigation, record decisions made about root cause fixes, and update the issue's progress checklist as you complete work, so any team member can pick up the task later without additional context.

Quick Start

Use the chalk skill to track your current work session against GitHub issue #123, following the required voice and comment structure for all issue-related prose.

Frequently Asked Questions about chalk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preserve implementation context in GitHub issue comments that gets lost in code diffs?

Structured session logging preserves implementation context in GitHub issue comments by formatting work logs with scannable checklists and detailed explanation blocks. This captures the reasoning behind decisions and what was tried, preventing lost context across development sessions.

How do I track GitHub issue progress so the description stays in sync with actual work?

Canonical progress tracking maintains an up-to-date checklist directly in the GitHub issue description. This ensures the issue always reflects the current state of work, allowing any team member to review completed and pending tasks without sifting through chat history.

What is the best way to format GitHub issue comments for individual and team development workflows?

The best way to format GitHub issue comments is by enforcing a standardized voice and structured comment format for all issue-related prose. This ensures implementation reasoning is clearly communicated to readers, keeping context clean across individual and team development workflows.

Can I use a dedicated agent to route GitHub interactions and keep issue context clean?

Yes, routing all GitHub interactions through a dedicated agent keeps context clean. This approach manages progress tracking and session logging, ensuring that issue descriptions and comments remain structured and synchronized with actual development work.

Does structured GitHub issue tracking work for resuming work on bug fixes reported by other team members?

Structured GitHub issue tracking works effectively for resuming bug fixes by logging each investigation step and recording root cause decisions in the issue's progress checklist. Any team member can pick up the task later without needing additional context transfer.

When should I not use structured session logs for GitHub issue tracking?

Structured session logs may be unnecessary for trivial changes where code diffs alone fully convey the implementation reasoning. If an issue requires minimal investigation or lacks team collaboration needs, enforcing canonical progress tracking and standardized comment formats adds overhead without clear benefit.