SkillsAdd

momhq/mom

mom-project

Bind the current directory to a MOM project so captured memories are scoped to it. Use when the user wants to set up project scoping, bind a repo, declare a project id, rebind a directory, or asks about .mom-project.yaml.

Hot #1984 First seen May 19, 2026

Installation

$ npx skills add momhq/mom --skill mom-project
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

xcode-project-setup Similar name
firebase/agent-skills

Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill …

104.1K installs
stripe-projects Similar name
stripe/ai

Use when the user wants to provision infrastructure or third-party services using Stripe Projec…

62.4K installs
persona-project-manager Similar name
googleworkspace/cli

Coordinate projects — track tasks, schedule meetings, and share docs.

28.5K installs
expo-project-structure Similar name
expo/skills

Framework (OSS). Folder structure for a new Expo app. Use when scaffolding or laying out a new …

11.3K installs
create-spring-boot-java-project Similar name
github/awesome-copilot

Create Spring Boot Java Project Skeleton

9.5K installs
project-workflow-analysis-blueprint-generator Similar name
github/awesome-copilot

Comprehensive technology-agnostic prompt generator for documenting end-to-end application workf…

9.4K installs

Also in this package

Other skills from momhq/mom.

npx skills add momhq/mom
mom-status 321 mom-rebuild 247 mom-fold 247 mom-wrap-up 79 mom-recall 77

Browse all from momhq/mom

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 60
License LICENSE
Default branch main
Open issues 10
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsBash(mom project*), Bash(cat .mom-project.yaml*), Bash(test -f .mom-project.yaml*), Bash(command -v mom*), Bash(brew install momhq/tap/mom*)

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,185 B
  • docs SUMMARY.md 240 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 280 installs

SKILL.md

Invoking this skill is the user's request to set up or change project scoping. Proceed with the flow below immediately — do not ask the user to confirm they want to bind. (The skill still asks for confirmation of the id itself in step 2.)

A bound directory has a .mom-project.yaml file at its root declaring a project id. Memories captured while working in that directory are tagged with that id, and recall scopes to it by default.

Preflight

Check that mom is on PATH:

command -v mom

If it is missing, tell the user MOM is not installed and ask permission to install it:

MOM is not installed. Install it now with Homebrew?
  brew install momhq/tap/mom
Source: https://github.com/momhq/mom

If the user agrees, run that command. If the user declines, stop. Do not install MOM without explicit permission.

Flow

  1. Check whether the current directory is already bound:

``bash test -f .mom-project.yaml && cat .mom-project.yaml ``

If the file exists, show the current id and ask the user to either keep it or rebind to a different one. Warn that rebinding does not merge memories from the old id — recall will only see memories tagged with the new id.

If the file does not exist, continue.

  1. Propose an id. Default to the current directory's basename, lowercased, trimmed, with spaces replaced by dashes. Show the proposal and ask the user to confirm or pick a different one.

The id is an opaque label. Suggest something specific (for example vendor/project or team-service) if the user might sync memories with other machines or teammates — unrelated projects sharing the same id will collide.

  1. Write the binding:

``bash mom project bind --id <chosen-id> ``

If the directory already declares a different id and the user agreed to rebind, append --force.

  1. Tell the user to commit .mom-project.yaml to version control so the binding travels with the repo.

Rules

  • Never run mom project bind without first confirming the id with the user.
  • Never run mom init from this skill.
  • If mom project bind returns an error, surface the error and stop.
  • Capture only begins after binding — until .mom-project.yaml exists, the watcher records nothing for this directory. Mention this when confirming a successful bind.
  • After a successful bind, confirm in one line that the directory is now bound to <id>.

Postflight (version hint)

Any mom ... command may print a banner to stderr like:

MOM 0.40.1 available. Run `brew upgrade mom` or `mom self-update`

If you see that line, finish the task first, then add one short line at the end of your reply suggesting the upgrade. Do not run the upgrade yourself.