- name
- knowledgebase-share
- description
- Operate a multi-agent shared knowledge layer backed by one GitHub repository. Use when setting up shared/private knowledge folders, enforcing branch+PR workflow, syncing branches, resolving merge conflicts, and standardizing how agents write/promote knowledge.
Knowledgebase Share
Use this skill as the single operating system for multi-agent knowledge storage.
Privacy rule (critical)
This is a reusable/public skill. Never hardcode user-specific repo URLs, paths, or secrets in SKILL.md. Always read config from references/kb-config.json (or user-provided override) before executing.
Required config
Read references/kb-config.json first.
Fields:
repo_url: canonical GitHub repo URL for knowledge storagelocal_path: local clone pathbranch: default branch (usuallymain)private_root: private notes root folder (defaultprivate)shared_root: shared notes root folder (defaultshared)
Repository model
<knowledge-repo>/
private/<agent>/
shared/
00_rules/
10_projects/
20_research/
30_decisions/
40_playbooks/
90_archive/
meta/
templates/Branch model
main: stable shared knowledgeagent/<name>: per-agent working branch- Shared knowledge enters
mainonly via PR
Operating rules
- Pull/rebase before writing:
git pull --rebase origin <branch> - Keep private drafts in
private/<agent>/ - Promote reusable content to
shared/via PR - Never force-push
main - No secrets/tokens in repository content
- Resolve conflicts by preserving both versions first, then refactor
Standard flows
A) Agent daily write (private)
- checkout
agent/<name> - write to
<private_root>/<name>/... - commit + push branch
B) Promote to shared knowledge
- copy/refine note into
<shared_root>/... - commit on
agent/<name> - open PR to
main - merge after review
C) Consume latest shared knowledge
- checkout local branch
git fetch origin- rebase from latest
main
Minimal commands (template)
# first-time clone
git clone <repo_url> <local_path>
# create agent branch
cd <local_path>
git checkout -b agent/<name>
# sync branch
git pull --rebase origin agent/<name>
# push updates
git push origin agent/<name>Boundary
- This skill governs knowledge layer operations only.
- Constitution / hard governance rules are maintained in the independent constitution system.