FrancoStino/context-kit

Context Kit

When to Use

Use this skill when the user wants to:

• Set up durable personal context files for Claude Code or another coding agent
• Compare Context Kit's Personal Context Artifact pattern with an existing memory or project-notes system
• Adapt a context template structure without copying private details into the chat
• Review whether a one-line installer or downloaded skill pack is appropriate before running it
• Create a safer, local-first plan for CRM notes, open loops, session digests, or morning briefings

Overview

Context Kit is an external project that organizes personal context into Markdown artifacts and companion Claude Code skills. This skill helps the user decide what to adopt, where to store it, and how to avoid turning a useful context system into a pile of sensitive data.

Treat every personal context file as private by default. These files may contain identity details, family context, work history, contact notes, mental models, health constraints, or relationship information. Do not paste them into third-party tools, public repositories, issue trackers, or model contexts unless the user explicitly approves the exact subset.

Safety Rules

1. Do not run a remote install script until the user has seen the command, source repository, and target paths it will write to.
2. Prefer cloning or downloading the repository for inspection before executing any installer:

   git clone https://github.com/JDDavenport/context-kit.git
   cd context-kit
   sed -n '1,220p' scripts/install.sh
   

3. Never store passwords, API keys, recovery codes, private keys, session tokens, or payment details in personal context artifacts.
4. If the user wants contact notes or CRM files, store only information they are comfortable keeping in local plaintext Markdown.
5. Before adding these files to a repo, confirm .gitignore excludes the chosen private context directory.
6. If adapting Context Kit to a team or company setting, separate personal context from company-confidential or customer-confidential information.

Setup Workflow

1. Ask what the user wants Context Kit to improve: session startup context, voice consistency, relationship memory, open-loop tracking, daily briefings, or handoff summaries.
2. Inspect the upstream project and installer before running anything.
3. Choose a storage location:
   • Claude Code default: ~/.claude/context/ and ~/.claude/skills/
   • Project-local context: .agent/context/ or another ignored directory
   • Portable setup: a private notes repo with explicit sync rules
4. Create a minimal starter set before filling everything:
   • pca-wiki.md for durable identity and domains
   • pca-mental-models.md for decision rules
   • pca-voice.md for writing preferences
   • pca-protocols.md for hard rules and boundaries
5. Add only enough detail to make the next agent session useful. Leave sensitive, speculative, or outdated details out until there is a clear reason to include them.
6. Add a recurring review cadence. Personal context goes stale quickly; stale context is worse than no context when it drives decisions.

Installation Review Checklist

Before running an installer, verify:

• The repository URL is exactly the one the user intended
• The script writes only to expected local directories
• The script does not upload files, send telemetry, or edit shell startup files unexpectedly
• The target directories are not inside a public repo
• The user has a rollback path, such as removing the copied templates and skills

If anything is unclear, stop at inspection and provide the user with the exact lines that need review.

Examples

Example: Inspect before installing

git clone https://github.com/JDDavenport/context-kit.git
cd context-kit
sed -n '1,220p' scripts/install.sh
find templates skills -maxdepth 2 -type f | sort

After inspection, summarize the files that would be installed and ask for confirmation before running the installer.

Example: Create a private project-local context directory

mkdir -p .agent/context
printf '.agent/context/\n' >> .gitignore
cp ~/Downloads/context-kit/templates/pca-wiki.md .agent/context/pca-wiki.md

Then trim the template to the minimum useful fields for the project instead of filling every personal section immediately.

Best Practices

• Keep context files short enough that an agent can read them at session start without drowning in stale detail.
• Separate durable facts from temporary state. Use project workplans or task trackers for temporary state.
• Label assumptions and uncertain memories instead of presenting them as facts.
• Review personal context after major life, role, health, or project changes.
• Store voice examples and anti-examples separately from private identity details when possible.

Common Pitfalls

• Running a shell installer directly from curl without inspecting it first
• Committing personal context files to a public repository
• Storing secrets because "the agent needs to know everything"
• Letting relationship or health notes become outdated and still treating them as current
• Copying upstream paid or license-unclear content instead of linking to it or writing original local notes

Limitations

• This skill does not verify the current upstream license or installer behavior on its own; inspect the live repository before running commands.
• It does not replace a dedicated secrets manager, CRM, password vault, or medical record system.
• It is for local personal context hygiene, not for collecting private information about other people without a legitimate reason.