# Send Project Context Sync to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "project-context-sync",
    "name": "Project Context Sync",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Joe3112/project-context-sync",
    "canonicalUrl": "https://clawhub.ai/Joe3112/project-context-sync",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/project-context-sync",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=project-context-sync",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/install.sh",
      "scripts/post-commit-hook.sh",
      "scripts/uninstall.sh",
      "scripts/update-context.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "project-context-sync",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T11:17:25.116Z",
      "expiresAt": "2026-05-14T11:17:25.116Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=project-context-sync",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=project-context-sync",
        "contentDisposition": "attachment; filename=\"project-context-sync-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "project-context-sync"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/project-context-sync"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/project-context-sync",
    "downloadUrl": "https://openagent3.xyz/downloads/project-context-sync",
    "agentUrl": "https://openagent3.xyz/skills/project-context-sync/agent",
    "manifestUrl": "https://openagent3.xyz/skills/project-context-sync/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/project-context-sync/agent.md"
  }
}
```
## Documentation

### project-context-sync

Keep a living project state document updated after each commit, so any agent (or future session) can instantly understand where things stand.

### What It Does

┌─────────────┐     ┌──────────────────┐     ┌─────────────────────┐
│ Git Commit  │ ──▶ │ Post-commit Hook │ ──▶ │ PROJECT_STATE.md    │
│             │     │                  │     │ (auto-updated)      │
└─────────────┘     └──────────────────┘     └─────────────────────┘

After each commit, the hook:

Gathers git info (last commit, recent history, branch, changed files)
Optionally calls an LLM to generate a smart summary
Updates PROJECT_STATE.md in the repo root

### Installation

# From the repo you want to enable:
cd /path/to/your/repo
/path/to/skills/project-context-sync/scripts/install.sh

Or if you have the skill in your path:

project-context-sync install

This will:

Install a post-commit hook in .git/hooks/
Create .project-context.yml with default config
Create initial PROJECT_STATE.md
Add PROJECT_STATE.md to .gitignore

### Uninstall

cd /path/to/your/repo
/path/to/skills/project-context-sync/scripts/uninstall.sh

### Manual Update

Trigger an update without committing:

cd /path/to/your/repo
/path/to/skills/project-context-sync/scripts/update-context.sh

### Configuration

Edit .project-context.yml in your repo root:

project_context:
  # Use AI to generate smart summaries (default: true)
  ai_summary: true
  
  # How many recent commits to include
  recent_commits: 5
  
  # Include diff stats in context
  include_diff_stats: true
  
  # Sections to include
  sections:
    - last_commit
    - recent_changes
    - current_focus    # AI-generated
    - suggested_next   # AI-generated

### AI Summary Mode

With ai_summary: true (default):

Generates intelligent summaries of what changed
Infers current focus from recent commit patterns
Suggests next steps
Costs tokens but provides rich context
Requires: Gateway HTTP API enabled (see below)

With ai_summary: false:

Just logs raw git info
Fast and free
Less intelligent but still useful

### Enabling the Gateway HTTP API

AI mode uses Clawdbot's OpenAI-compatible endpoint (/v1/chat/completions). This is disabled by default for security. To enable:

// ~/.clawdbot/clawdbot.json
{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": { "enabled": true }
      }
    }
  }
}

Security notes:

The endpoint inherits gateway auth (requires bearer token)
With bind: "loopback" (default), only local processes can connect
The script reads the token from ~/.clawdbot/clawdbot.json automatically
Risk is minimal for local development setups

### Output

PROJECT_STATE.md will contain:

# Project State
*Auto-updated by project-context-sync*

## Last Commit
- **Hash:** abc123
- **Message:** Implement isPro check for app blocking
- **Branch:** feature/subscription-gating
- **When:** 2026-01-29 12:34
- **Files changed:** 3

## Recent Changes
- abc123: Implement isPro check for app blocking
- def456: Add PaywallPrompt component
- ...

## Current Focus
[AI-generated summary of what's being worked on]

## Suggested Next Steps
[AI-suggested based on commit patterns]

### Notes

PROJECT_STATE.md is gitignored by default (regenerated locally)
The hook requires Clawdbot to be running for AI summaries
Without Clawdbot, falls back to raw git info mode
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Joe3112
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T11:17:25.116Z
- Expires at: 2026-05-14T11:17:25.116Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/project-context-sync)
- [Send to Agent page](https://openagent3.xyz/skills/project-context-sync/agent)
- [JSON manifest](https://openagent3.xyz/skills/project-context-sync/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/project-context-sync/agent.md)
- [Download page](https://openagent3.xyz/downloads/project-context-sync)