mskills

MTChen's personal agent skills, for every project. Plain Agent Skills (skills/<name>/SKILL.md) plus a Claude Code plugin that ships them with a hook.

Skills

Skill	What it does
`worktrees`	Git worktrees live at `<main-repo>/.claude/worktrees/<name>`. How to create, move and remove them, and how to git-ignore `.claude/worktrees/`.
`recall`	Finds every past session about one task, pulls that task out, fact-checks it against the real files, git and tools, and writes a focused brief plus a handoff prompt for a fresh session. Run it with `/mskills:recall <task>`.
`no-comments`	The code has no comments. Names carry the what, the docs carry the why; only tool directives are allowed.

Agents

Agent	Model	What it does
`comment-reviewer`	inherits	Applies `no-comments` to a diff or files: removes the comments, writes their reasons into the docs, suggests renames.
`session-reader`	Sonnet	Reads past sessions for `recall` and returns one task's claims, marked as said by the user or the agent.

Hook

hooks/worktree-guard.py is a PreToolUse hook on Bash that denies git worktree add and git worktree move to any path other than <main-repo>/.claude/worktrees/<name>. How it works: docs/worktree-guard.md. Needs python3 and git.

Install

Claude Code:

claude plugin marketplace add mtch3n/mskills
claude plugin install mskills@mskills

Then run /reload-plugins in an open session, or start a new one. Skills appear as /mskills:worktrees, /mskills:no-comments and /mskills:recall; the hook runs on every Bash call.

Other agents (skills only, no hook):

npx skills add mtch3n/mskills

One-time setup: ignore `.claude/worktrees/` globally

Without it, every repo shows .claude/ as untracked and git add -A commits a worktree as an embedded repository.

mkdir -p ~/.config/git
grep -qxF '.claude/worktrees/' ~/.config/git/ignore 2>/dev/null \
  || echo '.claude/worktrees/' >> ~/.config/git/ignore

If git config --global core.excludesFile prints a path, add the line there instead.

Layout

.claude-plugin/   Claude Code plugin and marketplace manifests
.cursor-plugin/   Cursor plugin manifest
plugin.json       agent-plugins.org manifest
skills/           one folder per skill
agents/           subagents the skills hand work to
hooks/            Claude Code hooks (hooks.json + scripts)
docs/             the why behind the hooks and skills

License

MIT