Skip to main content

synapsync add

Add cognitives from the registry, GitHub, or local files. Automatically syncs to configured providers after adding.

Usage​

synapsync add <source> [options]

Options​

OptionDescription
-t, --type <type>Cognitive type (skill, agent, prompt, workflow, tool)
-c, --category <cat>Category for organization
-f, --forceOverwrite if exists

Sources​

Registry​

Add by name from the public registry:

synapsync add code-reviewer

GitHub​

Using shorthand:

synapsync add github:user/repo
synapsync add github:user/repo#branch

Using full URL:

synapsync add https://github.com/user/repo

Local Path​

synapsync add ./path/to/cognitive
synapsync add /absolute/path/to/skill

Examples​

Basic Add​

synapsync add code-reviewer
✓ Found 'code-reviewer' in registry
✓ Downloaded to .synapsync/skills/general/code-reviewer/
✓ Installed code-reviewer v1.0.0
  Syncing to providers...
✓ Synced to claude (1 created)

Add with Category​

synapsync add react-patterns --category frontend

Saves to .synapsync/skills/frontend/react-patterns/

Force Reinstall​

synapsync add code-reviewer --force

Overwrites existing installation.

Add Agent from GitHub​

synapsync add github:synapsync/feature-branch-manager --type agent

Installed Location​

Cognitives are stored in .synapsync/ organized by type and category:

.synapsync/
├── skills/
│   └── general/
│       └── code-reviewer/
│           └── SKILL.md
└── agents/
    └── devops/
        └── deploy-manager/
            └── AGENT.md

Notes​

  • Cognitives are automatically synced to providers after adding
  • Type is auto-detected from registry metadata
  • Category defaults to general if not specified
  • GitHub repos must contain a valid cognitive file (SKILL.md, AGENT.md, etc.)