Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

knowledge-sync-plus

hero

License: MIT Works with Claude Code Skill v1.0 Zero dependencies

Built on affaan-m/ECC by @affaan-m (259,129 stars, MIT). All credit for the original idea to them. This fork improves and repackages it; upstream license preserved in UPSTREAM_LICENSE.

A Claude Code skill that keeps facts easy to find, puts each fact in one main home, and cleans up duplicate notes.

💡 Why

Facts can end up in local files, memory, GitHub, Linear, and data stores.

Copies get old. Notes lose their source. It gets hard to know which fact is right.

This skill is for people who use Claude Code across many tools. It helps Claude pick the right home, check for old copies, and keep clear links between stores.

It is a single skill file with no added packages. It plugs into your current Claude Code flow.

📦 Install

Replace OWNER with the GitHub name that owns this repo, then run:

mkdir -p ~/.claude/skills/knowledge-ops && curl -fsSL https://raw.githubusercontent.com/OWNER/knowledge-sync-plus/main/skill/SKILL.md -o ~/.claude/skills/knowledge-ops/SKILL.md

🚀 Usage

Ask Claude Code:

Import these release notes into my knowledge base. Check for old copies first. Keep the current release state in the project repo, and add only a short linked note to memory.

Expected result:

Claude checks which stores are ready and searches for a match. It checks the source, owner, date, trust, and secrets. It updates the store that owns the live work first. It keeps long text in the knowledge base and adds only short notes or links elsewhere. It reads back each changed record and reports any store it had to skip.

A simple guide helps Claude choose:

Kind of knowledge Main home
Current plan, release, or code state GitHub, Linear, or project repo
User choice or small fact Claude Code memory
People, tools, projects, and links MCP memory
Long notes and chat exports Knowledge base repo
Large sets of records Data store
Short-term notes Local archive

🔧 What we changed vs upstream

  • Rewritten from dense Japanese into clearer, simpler English with a more scannable structure.
  • Adds explicit safety and authorization rules: no unsolicited external calls, commits, or pushes, and never store credentials or login data.
  • Clarifies canonical ownership by requiring one main home per fact, with only short linked notes elsewhere.
  • Makes storage behavior conditional and tool-aware, including checking paths first and skipping unavailable MCP memory cleanly.
  • Adds a practical decision table and stronger import checks for source, ownership, freshness, trust, and secrets.

📄 License

This project is released under the MIT License. The upstream MIT license and credit are preserved in UPSTREAM_LICENSE.

About

Free Claude Code skill to save, sync, clean, and search knowledge across files, memory, data stores, and Git. Built on affaan-m/ECC.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors