Repolode
Submit
dongshuyan

dongshuyan/compass-skills

A local, file-based set of ten SKILL.md agent skills for task clarification, task tracking, pausing and handoff, profile memory, skill building, and writing.

View on GitHub
Stars
759
Forks
61
Open issues
0
Last commit
3 days ago

What is it?

COMPASS Skills is a collection of ten SKILL.md packages that give AI coding agents reusable workflows for long-running and ambiguous work. They are installable through the skills CLI for Claude Code and Codex, and most run as plain instructions with optional Python scripts that use the standard library.

The skills cover several kinds of state that agents usually lose between conversations: a repo-local task forest with goals, subtasks, dependencies and decisions; a cooperative pause checkpoint for resuming in the same conversation; a paste-ready handoff prompt for starting a fresh one; and a local, editable user profile for communication preferences. A clarifier skill asks focused questions before costly or risky execution, and a run-history builder and upgrader turn real session evidence into new or revised skills, applying changes only after approval.

The project also includes writing skills: clear-communication for reader-oriented explanations and reports, and academic-humanizer for revising English and Chinese academic prose while keeping claims intact. A local interview-support skill prepares an offline HTML report from an authorized resume and job description. Runtime data is stored locally by default.

Key features

  • 01Ten installable SKILL.md skills covering task alignment, task tracking, pause/resume and handoff.
  • 02Repo-local task forest with goals, subtasks, dependencies, progress and decisions, exportable to HTML.
  • 03Local user profile that can be inspected and corrected; secrets are kept out of it.
  • 04Skill-upgrade loop that proposes changes from session evidence and applies them only after approval.
  • 05Writing aids for clear explanations and for revising academic prose without changing claims.

Use cases

  • Clarifying a vague or costly task with an agent before it starts executing.
  • Pausing a long coding session and resuming it later in the same conversation.
  • Moving unfinished work into a new AI conversation with a compact handoff prompt.
  • Packaging a repeatedly used workflow into a reusable skill for Claude Code or Codex.

Quick start

  1. 1

    List the available skills before installing

    npx skills add dongshuyan/compass-skills --list
  2. 2

    Install all skills for Claude Code

    npx skills add dongshuyan/compass-skills --skill '*' -a claude-code

Things to know

  • The project is marked alpha, so behavior and interfaces may change.
  • Installation depends on the npx skills tool and a supported agent host such as Claude Code or Codex.

Topics

#agent-skills#ai-agents#claude-code#codex#task-management#workflow-automation#local-first#prompt-engineering#agent-memory#agent-skill

FAQ

What is compass-skills?
A local, file-based set of ten SKILL.md agent skills for task clarification, task tracking, pausing and handoff, profile memory, skill building, and writing. COMPASS Skills is a collection of ten SKILL.md packages that give AI coding agents reusable workflows for long-running and ambiguous work. They are installable through the skills CLI for Claude Code and Codex, and most run as plain instructions with optional Python scripts that use the standard library.
Is compass-skills free to use? What license does it have?
compass-skills is open source under the MIT license. Check the license terms before using it in commercial products.
Is compass-skills still maintained?
Actively maintained. The last commit to compass-skills was on Oct 19, 2026.
What can I use compass-skills for?
Clarifying a vague or costly task with an agent before it starts executing. Pausing a long coding session and resuming it later in the same conversation. Moving unfinished work into a new AI conversation with a compact handoff prompt. Packaging a repeatedly used workflow into a reusable skill for Claude Code or Codex.
How do I install compass-skills?
List the available skills before installing: npx skills add dongshuyan/compass-skills --list Install all skills for Claude Code: npx skills add dongshuyan/compass-skills --skill '*' -a claude-code
Where can I get compass-skills?
The source code and installation instructions are on GitHub: https://github.com/dongshuyan/compass-skills

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects