# Sync

> Use when syncing Tiro meeting notes and transcripts into an LLM Wiki — discovers notes not yet ingested, downloads them into raw/ via the Tiro CLI, and runs the ingest workflow on each, idempotently and without ever modifying existing raw files.

- **Type:** Skill
- **Install:** `agentstack add skill-plato-corp-skills-sync`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [plato-corp](https://agentstack.voostack.com/s/plato-corp)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [plato-corp](https://github.com/plato-corp)
- **Source:** https://github.com/plato-corp/skills/tree/main/plugins/tiro/skills/sync

## Install

```sh
agentstack add skill-plato-corp-skills-sync
```

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

## About

# Sync — Tiro notes → wiki

Pull your Tiro meeting notes and transcripts into the wiki so your conversations become part of your compounding knowledge base. Tiro is the source of truth; `raw/` preserves originals; `wiki/sources/` gets one page per note.

## Prerequisites

- [Tiro](https://tiro.ooo) account with notes, and the Tiro CLI:
  ```
  npm install -g @theplato/tiro-cli
  tiro auth login
  ```
- An LLM Wiki (create one with `/tiro:bootstrap-wiki` if needed).

## Usage

```
/tiro:sync [optional: --since 7d | --all-history]
```

## Workflow

1. **Verify access.** `tiro auth status --json`. On auth failure, tell the user to run `tiro auth login` — do not retry automatically.
2. **Discover.** List candidate notes:
   ```
   tiro notes list --since 30d --json
   ```
   (default window 30d; honor the user's `--since` / full-history request). Compare against notes already in the wiki — source pages record the note GUID (first 8 characters in the filename and/or `source_path`), so a note already ingested is skipped. Same GUID is never ingested twice; **idempotent by GUID**, not by title — duplicate titles with different GUIDs are all kept.
3. **Download** each new note into `raw/tiro/`:
   ```
   tiro notes get  --output raw/tiro/--.md --include transcript
   ```
   One note's failure must not block the rest; collect failures and report them at the end.
4. **Ingest** each downloaded note with the ingest workflow (`/tiro:ingest`): source page with `source_path`, entity/concept/topic updates, cross-references, index/log/overview.
   - For large batches: source pages may be created in parallel, but shared files (`index.md`, `log.md`, `overview.md`, entity/concept/topic pages) are merged **sequentially at the end** — never concurrently.
5. **Report.** Notes found / already-synced / newly downloaded / ingested / failed. Offer to commit.

## Invariants

- Never modify, overwrite, or delete existing files in `raw/`.
- Every source page records `source_path` back to the raw file.
- Re-running the same sync is always safe (idempotence by GUID).

## Make it a habit

Run `/tiro:schedule-sync` once to register a recurring daily sync — the wiki stays current without anyone remembering to do it.

## Source & license

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

- **Author:** [plato-corp](https://github.com/plato-corp)
- **Source:** [plato-corp/skills](https://github.com/plato-corp/skills)
- **License:** MIT

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:** no
- **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-plato-corp-skills-sync
- Seller: https://agentstack.voostack.com/s/plato-corp
- 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%.
