dongshuyan/compass-skills

司南：个性化 AI 任务总控 Skills 系统 /COMPASS: Personal Alignment Skills OS for AI Agents

What it solves

COMPASS Skills provides a set of reusable, local workflows (skills) for AI agents to manage long-running, complex work. It addresses the lack of persistent state across AI conversations, such as user preferences, project progress, task dependencies, and the ability to safely pause and resume work without losing context.

How it works

The project implements these workflows as SKILL.md packages containing Markdown instructions, YAML frontmatter, and optional scripts. These skills can be installed into agent runtimes like Claude Code or Codex. They allow agents to maintain a local user profile, track tasks via a repo-local task graph (DAG), create handoff prompts for new conversations, and use a structured clarification process to align on goals before executing risky or ambiguous tasks.

Who it’s for

Developers and power users of AI agents (such as Claude Code or Codex) who manage complex, long-term projects and need the agent to remember context, follow specific collaboration styles, and maintain a structured task history.

Highlights

  • State Management: Includes tools for maintaining user profiles, task forests (DAGs), and session handoffs.
  • Sef-Evolution Loop: Features a run-history-skill-upgrader that turns real execution evidence into approved upgrade plans for existing skills.
  • Task Alignment: A task-clarifier that forces the agent to resolve ambiguities and confirm requirements before acting.
  • Academic Humanizer: A specialized tool to remove AI-sounding patterns from scholarly prose while preserving technical claims.
  • Local-First Safety: All runtime data, including user profiles and task graphs, is stored locally to avoid data uploads.

Related

  • Project
    mohitagw15856/pm-claude-skills

    PM Skills is an open‑source library of 1 169 markdown “Agent Skills” that give Claude, ChatGPT, Gemini, etc. concrete, senior‑level procedures for professional and life‑admin tasks (e.g., lease decoding, PRD writing, salary‑negotiation simulation). Skills are plain markdown files containing framework, template, checks, and anti‑patterns. They can be installed with a one‑line `npx` command, used natively in Claude Code, or pasted into prompts for other agents. The repo also provides npm/PyPI packages, Docker image, and integrations (Telegram, Slack, Raycast, Obsidian, n8n). A web playground lets anyone run a skill in the browser without installing anything.

  • Project
    HoangNguyen0403/agent-skills-standard

    Agent Skills Standard (AGS) is an NPM‑distributed CLI that lets teams publish their coding‑standards, security rules, and SDLC workflow templates as tiny markdown “skills”. The CLI (`ags init` / `ags sync`) creates a `.skillsrc` config, downloads language‑specific skill packs (280 skills across 20+ stacks), and writes a hierarchical router (`AGENTS.md → _INDEX.md → SKILL.md`). AI coding assistants (Cursor, Claude Code, Copilot, Gemini, etc.) read this router and load only the relevant rules for the file they are editing, saving ~85 % of prompt tokens. An optional MCP server can enforce hooks, block secret‑leak edits, and provide runtime audit logs. The project is a genuine AI‑coding‑assistant utility, not a generic tutorial or list.

  • Project
    MoizIbnYousaf/ai-agent-skills

    AI Agent Skills is an npm‑based CLI/TUI that ships a curated library of ~115 AI‑agent “skills” (prompt‑code bundles) organized into shelves (frontend, backend, mobile, workflow, agent‑engineering, marketing). It lets you browse, search, install, and manage both local “house‑copy” skills and upstream metadata‑only skills. You can also bootstrap a personal library with `init-library`, add or catalog new skills, vendor copies, sync updates, and generate documentation. Works with any Agent‑Skills‑compatible agent (Claude, Cursor, Gemini, etc.) and supports multiple install targets. Ideal for developers or teams who want a tidy, searchable toolbox of reusable agent capabilities.

  • Project
    xstongxue/best-skills

    A collection of high-quality SKILL.md files for AI agents (Cursor, Claude Code, etc.) that enable automatic task triggering for academic writing, diagramming, and development workflows.

  • Project
    DenisSergeevitch/agents-best-practices

    A provider-neutral framework of best practices and blueprints for designing production-safe agentic harnesses that separate model proposals from runtime execution and authorization.