# Worksync

> >

- **Type:** Skill
- **Install:** `agentstack add skill-lexfrei-ccc-worksync`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [lexfrei](https://agentstack.voostack.com/s/lexfrei)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** BSD-3-Clause
- **Upstream author:** [lexfrei](https://github.com/lexfrei)
- **Source:** https://github.com/lexfrei/ccc/tree/master/hooks/worksync/skills/worksync

## Install

```sh
agentstack add skill-lexfrei-ccc-worksync
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# worksync — log a sync-worthy entry

Appends a single timestamped bullet to today's note at
`${WORKSYNC_VAULT_DIR:-$HOME/worksync}/YYYY-MM-DD.md` via the bundled helper
script `${CLAUDE_PLUGIN_ROOT}/scripts/worksync-append.sh`.

The file's purpose: a low-friction daily log of things the user will want to
mention at a work sync, standup, or weekly review. Phrase entries for a
technical peer audience.

## Arguments

The skill accepts a free-form argument from `$ARGUMENTS`:

- If non-empty: treat it as the message, with optional leading type hint.
- If empty: derive message from recent session activity (see "Inferring content" below).

Supported types (passed as first arg to the helper):

| Type         | When to use                                                              |
|--------------|--------------------------------------------------------------------------|
| `research`   | A question was investigated and produced a concrete finding or decision. |
| `ops`        | A deploy, rollout, migration, or infrastructure operation finished.      |
| `checkpoint` | User-requested mid-task marker ("log this", "checkpoint").               |
| `note`       | Anything else worth mentioning that doesn't fit the above.               |

Types `pr`, `issue`, `merge` are **reserved for the automatic hook** — do not
emit them from the skill. If the user explicitly asks to log one manually, use
`note` and include the URL in the message.

## Inferring content (no arguments case)

When invoked with no arguments, scan the most recent turns of the current
session and produce ONE entry summarizing the most recent sync-worthy event.
Do not produce multiple entries in one invocation — call the skill again if
more is needed.

Selection priority (pick the most recent qualifying item):

1. An `ops` action that visibly succeeded (deploy, apply, rollout, migration,
   infrastructure reconfiguration, provisioning run against real hosts).
2. A `research` conclusion — user asked a question, you investigated, you
   reached a definite answer or recommendation.
3. A `checkpoint` the user explicitly requested.

Skip if the most recent activity was just reading/exploring without producing
a decision or action — nothing to log yet.

## Message format

Keep the message to one line, English, technical-peer tone.

Good examples:

- `research` — `confirmed HTTP/2 keepalive is the right fix for the connection-reset issue; ADR pending`
- `ops`      — `rolled out v1.42.3 to staging, all replicas healthy inside 90s`
- `ops`      — `ran db migration 0042 on production, 0 rows skipped, 12s runtime`
- `research` — `decided to drop Redis cluster mode — single-primary + replica covers our load`

Bad examples (do not emit):

- `checked pod status` (not sync-worthy)
- `discussed architecture` (no outcome)
- anything with customer names, credentials, or internal-only identifiers

## Execution

Run the helper script. Do not write to the file directly — the helper handles
directory creation, date-based filenames, and deduplication.

```bash
"${CLAUDE_PLUGIN_ROOT}/scripts/worksync-append.sh"  ""
```

Exit on failure is fine — surface the error to the user. On success, reply
with one short line: which file was updated and what was logged.

## Redaction rules

Before appending, strip or rewrite:

- Customer, client, or project names → generic labels ("production cluster",
  "test environment", "a customer request").
- Internal hostnames or cluster identifiers that reveal topology → generic.
- Credentials, tokens, private IP addresses, internal URLs.

If the event cannot be described without private details, log a vague version
("reviewed an internal auth change") rather than skipping — the user still
wants a timestamp marker they can expand on verbally at the sync.

## Configuration

Users can point the note directory at any location by exporting
`WORKSYNC_VAULT_DIR` in their shell, Claude `settings.json` `env` block, or a
project `.env`. Common targets:

- `~/Documents/Obsidian/MyVault/worksync` — Obsidian vault subfolder
- `~/Library/Mobile Documents/iCloud~md~obsidian/Documents//worksync` — macOS iCloud-synced Obsidian vault
- `~/logseq/journals/worksync` — Logseq graph
- `~/worksync` — the default, plain folder

Daily files are plain markdown, so any editor will do.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [lexfrei](https://github.com/lexfrei)
- **Source:** [lexfrei/ccc](https://github.com/lexfrei/ccc)
- **License:** BSD-3-Clause

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-lexfrei-ccc-worksync
- Seller: https://agentstack.voostack.com/s/lexfrei
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.