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 storage
• local_path: local clone path
• branch: default branch (usually main)
• private_root: private notes root folder (default private)
• shared_root: shared notes root folder (default shared)

Repository model

\x3Cknowledge-repo>/
  private/\x3Cagent>/
  shared/
    00_rules/
    10_projects/
    20_research/
    30_decisions/
    40_playbooks/
    90_archive/
  meta/
  templates/

Branch model

• main: stable shared knowledge
• agent/\x3Cname>: per-agent working branch
• Shared knowledge enters main only via PR

Operating rules

1. Pull/rebase before writing: git pull --rebase origin \x3Cbranch>
2. Keep private drafts in private/\x3Cagent>/
3. Promote reusable content to shared/ via PR
4. Never force-push main
5. No secrets/tokens in repository content
6. Resolve conflicts by preserving both versions first, then refactor

Standard flows

A) Agent daily write (private)

1. checkout agent/\x3Cname>
2. write to \x3Cprivate_root>/\x3Cname>/...
3. commit + push branch

B) Promote to shared knowledge

1. copy/refine note into \x3Cshared_root>/...
2. commit on agent/\x3Cname>
3. open PR to main
4. merge after review

C) Consume latest shared knowledge

1. checkout local branch
2. git fetch origin
3. rebase from latest main

Minimal commands (template)

# first-time clone
git clone \x3Crepo_url> \x3Clocal_path>

# create agent branch
cd \x3Clocal_path>
git checkout -b agent/\x3Cname>

# sync branch
git pull --rebase origin agent/\x3Cname>

# push updates
git push origin agent/\x3Cname>

Boundary

• This skill governs knowledge layer operations only.
• Constitution / hard governance rules are maintained in the independent constitution system.