agent-skills

Shared agent skills for Claude Code and Cursor, distributed via a Node.js CLI. Skills are agent-agnostic — the same skill works in both tools without modification.

Install

npx @audiohook/agent-skills install

Or install globally:

npm install -g @audiohook/agent-skills

This installs all skills to:

• Claude Code → ~/.claude/skills/{name}/SKILL.md
• Cursor → ~/.cursor/rules/{name}.mdc

Commands

| Command | Description | |---------|-------------| | npx @audiohook/agent-skills install | Install all skills | | npx @audiohook/agent-skills update | Update all installed skills | | npx @audiohook/agent-skills update <name> | Update a specific skill | | npx @audiohook/agent-skills status | Compare local vs remote versions | | npx @audiohook/agent-skills list | List available skills with versions |

Notion Setup

The notion-sync skill uses the Notion MCP for authentication — no token or env var needed. Add the Notion MCP server to your agent's MCP settings and connect your workspace via OAuth.

If the Notion MCP is not available, the skill falls back to NOTION_TOKEN:

export NOTION_TOKEN=ntn_xxxxx  # add to ~/.zshenv or ~/.bashrc

Get your token at https://notion.so/my-integrations

Google Drive Setup

After installing, add your shared folder ID to your shell environment:

export GDRIVE_FOLDER_ID=your_folder_id  # add to ~/.zshenv or ~/.bashrc

To get the folder ID: open the shared folder in Google Drive and copy the ID from the URL: drive.google.com/drive/folders/{FOLDER_ID}

The gdrive-sync skill uses this to upload README.md to the shared folder.

Linear Setup

The linear-issue skill uses the Linear MCP server — no token or env var needed. Authentication is handled by the MCP itself. To set it up, add the Linear MCP server to your agent's MCP settings, then run:

! npx @linear/mcp auth

Once authenticated, linear-issue will automatically use the logged-in user as the assignee.

Skills

plan

Triggered by: plan [description]

Produces a structured analysis (type, branch name, problem, approach, files, out of scope) and saves it to .plan in the project root.

done

Triggered by: done

Reads the current plan (.plan, Claude Code plan, or Cursor plan), reviews the actual git diff, delegates the README update to readme-update, generates a PR description, and offers to sync to Notion. Deletes .plan when done.

readme-update

Triggered by: readme-update

Creates or updates README.md with a new entry in ## Recent Changes and optionally ## Non-obvious Decisions. When run standalone, infers the change from session context + git diff and asks the user to confirm before writing. After updating, offers to invoke notion-sync. Can also be invoked by other skills (e.g. done) with pre-resolved context.

notion-sync

Triggered by: notion-sync

Syncs the README's Recent Changes and Non-obvious Decisions sections to a Notion project page. Uses the Notion MCP for authentication (OAuth); falls back to NOTION_TOKEN if the MCP is not available.

linear-issue

Triggered by: linear-issue

Creates a Linear issue from the current session context and git diff — uses what was actually implemented, not necessarily what was planned. Falls back to plan files if there is no session context. Sets the authenticated user as assignee, adds to the active cycle, and marks the issue as In Progress. Requires the Linear MCP server to be configured.

repo-context

Triggered by: repo-context

Loads the project's README into the current session as active context. Reads the project description, recent changes, non-obvious decisions, and current git state, then reports a concise summary. Use this at the start of a session so the LLM understands the repo without requiring manual explanation.

gdrive-sync

Triggered by: gdrive-sync

Uploads the project's README.md to a shared Google Drive folder as {project-name}-README.md. Creates or updates the file. Requires GDRIVE_FOLDER_ID in the environment.

Non-obvious Decisions

• Bundled registry read on install (2026-04-22): install reads skills from the local package instead of fetching from GitHub at runtime, so it works without network access and always installs exactly the version that shipped with the package. The remote fetchSkillContent path is kept but is no longer called during install.

Recent Changes

| Date | Type | Summary | PR | |------|------|---------|-----| | 2026-04-22 | feature | added gdrive-sync skill and auto-configured Notion and Google Drive MCP servers on install | — | | 2026-04-22 | bug | fixed install to read bundled registry and skills locally, removing network dependency; fixed missing execute permission on CLI entry point | — | | 2026-04-30 | feature | added linear-issue skill to create Linear issues from a plan, auto-assigned and set to In Progress via Linear MCP | — | | 2026-05-13 | feature | added repo-context skill; redesigned done, readme-update, linear-issue for skill composition and session-first context; migrated notion-sync to MCP OAuth | — |