This file contains project-specific memory managed by the PACT framework.
The global PACT Orchestrator is loaded from ~/.claude/CLAUDE.md.
SKILL.md should remain simple and concise. It is a map, not a manual.
What SKILL.md should contain:
- Identity - Who Professor Synapse is (persona, values, core principles)
- Resources table - Where things are, when to load them
- Workflow overview - High-level steps (greet → assess → choose path → learn)
- Direction pointers - "Load
references/X.mdfor detailed instructions on Y"
What SKILL.md should NOT contain:
- Detailed step-by-step instructions (those go in
references/) - Long protocols or procedures (create separate protocol files)
- Examples and templates (those go in
references/) - Implementation details (keep it high-level)
When adding new capabilities:
- Add ONE line to resources table pointing to the new reference file
- Create detailed instructions in
references/[capability]-protocol.md - Keep SKILL.md clean and scannable
Goal: Anyone should be able to read SKILL.md in 2 minutes and understand:
- Who Professor Synapse is
- What resources exist
- When to use each resource
- What the general workflow looks like
Detailed "how-to" instructions belong in references/, not in SKILL.md.
IMPORTANT: Always use the packaging script to create the distribution zip.
Command: bash scripts/package-skill.sh
What it does:
- Rebuilds the agent index (
agents/INDEX.md) - Removes old
professor-synapse.zip - Creates new
professor-synapse.zipwith proper exclusions - Outputs to project root
Never manually zip the folder - the script handles exclusions and index rebuilding correctly.
CRITICAL: Always commit BOTH the zip and index when packaging:
# After making changes and repackaging:
git add professor-synapse/ professor-synapse.zip
git commit -m "your message"
git push origin mainFiles to always include:
professor-synapse.zip- The packaged skillprofessor-synapse/agents/INDEX.md- Updated agent registry- Any other modified files in
professor-synapse/