← Back to Skills Marketplace
joe3112

Project Context Sync

by Joseph Sagiv · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2874
Downloads
3
Stars
9
Active Installs
1
Versions
Install in OpenClaw
/install project-context-sync
Description
Automatically updates PROJECT_STATE.md after each commit with recent git info and optional AI-generated summaries to track project status and next steps.
Usage Guidance
What to check before installing: - Review the scripts locally (install.sh, update-context.sh, post-commit-hook.sh). The installer will modify .git/hooks/post-commit and write .project-context.yml and PROJECT_STATE.md into the repo. - Understand AI mode: if ai_summary: true, the hook may read ~/.clawdbot/clawdbot.json or the CLAWDBOT_TOKEN env var and POST commit context (commit messages, changed filenames, diff stats) to http://localhost:<port>/v1/chat/completions with that bearer token. Confirm your Clawdbot gateway is configured to bind only to loopback and is not proxying requests to an external/untrusted service. - Secrets: the script reads a token from your home config — treat that as sensitive. If you don't want any tokens read or network calls, set ai_summary: false in .project-context.yml before installing. - Tooling: the scripts use git, curl, and optionally jq; ensure those are available. Note sed -i '' is BSD/macOS style and may not work unchanged on Linux (the install/uninstall scripts use it). - Test safely: install in a disposable/test repository first to observe behavior. Make a commit and inspect PROJECT_STATE.md and whether any network calls occur (e.g., run update-context.sh manually and watch curl). - Uninstall: uninstall.sh will attempt to remove the hook or the appended lines; it leaves PROJECT_STATE.md and .project-context.yml in place (remove manually if desired). Given the undeclared access to a local token file and the potential to transmit repository information, proceed only if you trust the code and your local Clawdbot gateway configuration. If you want to be conservative, disable ai_summary or inspect/modify update-context.sh to remove or alter the network call before installing.
Capability Analysis
Type: OpenClaw Skill Name: project-context-sync Version: 1.0.0 The skill `project-context-sync` is designed to auto-update a `PROJECT_STATE.md` file in a Git repository after each commit. It achieves this by installing a `post-commit` Git hook. The skill can optionally use a local Clawdbot AI gateway to generate smart summaries, which involves reading the `CLAWDBOT_TOKEN` from `~/.clawdbot/clawdbot.json` and making a `curl` request to `http://localhost:$GATEWAY_PORT`. While accessing a credential file (`~/.clawdbot/clawdbot.json`) is a sensitive operation, it is explicitly documented in `SKILL.md` and `README.md`, and the token is used solely for local communication with the Clawdbot gateway, aligning with the skill's stated purpose. There is no evidence of data exfiltration to external endpoints, malicious execution, or prompt injection attempts against the agent.
Capability Assessment
Purpose & Capability
The skill's name and files match its stated purpose (install a post-commit hook that keeps PROJECT_STATE.md up-to-date). However, the shipped scripts read a Clawdbot gateway config (~/.clawdbot/clawdbot.json) and may use a CLAWDBOT_TOKEN — these runtime interactions are related to the AI-summary feature but are not declared in the skill's metadata (no required env vars or binaries are listed).
Instruction Scope
The runtime script (update-context.sh) collects repository metadata (commit messages, changed files, diff stats) and, when AI mode is enabled, will send that context to a local HTTP gateway endpoint (/v1/chat/completions) with a bearer token read from the user's Clawdbot config or from environment (CLAWDBOT_TOKEN). That behavior is within the feature's scope, but it reads a user config file and a secret token (undocumented in metadata) and transmits repository context to a network endpoint — potential data exposure if the gateway is misconfigured or forwards requests externally.
Install Mechanism
No external downloads or remote installs are performed; install.sh copies provided scripts into the repository's .git/hooks and writes .project-context.yml and PROJECT_STATE.md. This is expected for a hook-based tool, but it does modify repo hooks and .gitignore. The install script also uses sed -i '' (BSD sed) which may be platform-specific.
Credentials
skill.json declares no required env vars or binaries, but update-context.sh expects git, curl, and (optionally) jq and reads ~/.clawdbot/clawdbot.json or CLAWDBOT_TOKEN for a bearer token. The token read from the user's home config is effectively a secret; requesting/using it is relevant to AI summaries but the metadata doesn't declare that requirement or ask for user confirmation, so there's a mismatch.
Persistence & Privilege
always is false and the skill only installs a per-repository post-commit hook (no system-wide always-on flag). The hook runs update-context.sh in the background on each commit. It does not modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install project-context-sync
  3. After installation, invoke the skill by name or use /project-context-sync
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: auto-update PROJECT_STATE.md with AI-powered summaries after each commit
Metadata
Slug project-context-sync
Version 1.0.0
License
All-time Installs 9
Active Installs 9
Total Versions 1
Frequently Asked Questions

What is Project Context Sync?

Automatically updates PROJECT_STATE.md after each commit with recent git info and optional AI-generated summaries to track project status and next steps. It is an AI Agent Skill for Claude Code / OpenClaw, with 2874 downloads so far.

How do I install Project Context Sync?

Run "/install project-context-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Project Context Sync free?

Yes, Project Context Sync is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Project Context Sync support?

Project Context Sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Project Context Sync?

It is built and maintained by Joseph Sagiv (@joe3112); the current version is v1.0.0.

💬 Comments