Skip to content

shared/

Canonical tool-agnostic resources. Both Claude Code and Cursor reference content from here — this is the single source of truth for reusable assets.

Contents

Directory / File Purpose
skills/ Skill definitions (SKILL.md files). .cursor/skills/ symlinks here.
rules/ Global baseline rules and stack modules. Global baseline lives in rules/global-baseline/.
agents/ Agent definitions
plugin/ Legacy Cursor plugin bundle (archived; superseded by skills/ and rules/)
personal-operating-manual.md How you work — preferences, rituals, tool choices
mcp-integration-decision.md MCP server selection rationale and integration notes

Tool registration

Cursor

Cursor reads skills from .cursor/skills/, which symlinks each skill from shared/skills/<name> (cd .cursor/skills && ln -s "../../shared/skills/<skill-name>" <skill-name>).

Claude Code

User-level skills live at ~/.claude/skills/. Project-scoped skills can be added to .claude/skills/. Canonical definitions and documentation always live here in shared/skills/.

Adding a new skill

  1. Create shared/skills/<skill-name>/SKILL.md with the skill definition
  2. Note the skill in this README
  3. Register in the appropriate tool config (see above)
  4. If user-global, also install to ~/.claude/skills/<skill-name>/