# Background Marketplace Reconciliation

> Run marketplace diff and reconciliation in the background while surfacing per-source progress to the UI without blocking startup.

- **Type:** Skill
- **Install:** `agentstack add skill-ychampion-cskill-agents-background-marketplace-reconciliation`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ychampion](https://agentstack.voostack.com/s/ychampion)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ychampion](https://github.com/ychampion)
- **Source:** https://github.com/ychampion/cskill-agents/tree/main/agents/claude-code/skills/background-marketplace-reconciliation
- **Website:** https://x.com/YashasGunderia/status/2039990540016693692?s=20

## Install

```sh
agentstack add skill-ychampion-cskill-agents-background-marketplace-reconciliation
```

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

## About

# SKILL: Background Marketplace Reconciliation
**Domain:** tool-orchestration
**Trigger:** Use when you need to reconcile declared plugin marketplaces or source registries without blocking startup or the main command loop.
**Source Pattern:** Distilled from reviewed plugin-source reconciliation and background install lifecycle implementations.

## Core Method
Diff the declared marketplace or plugin-source configuration against the current cached state before doing any network work. Seed UI state with a `pending` entry for every source that needs installation or update, then run the actual reconciliation in the background. As progress events arrive, map them onto visible install states so the product can show spinners, success, and failure per source without freezing the main UI. When reconciliation finishes, clear stale caches and branch on the outcome so new installs, updates, and failures each trigger the right downstream behavior.

## Key Rules
- Populate visible state with `pending` rows before the async work begins so the UI can render progress immediately.
- Use progress callbacks to update each source row (`installing`, `installed`, `failed`) and attach any error text for diagnostics.
- Keep analytics/logging around the whole operation so you know how many installed/updated/failed entries returned.
- After the promise resolves, clear caches and trigger refresh or flag-for-refresh decisions rather than leaving stale extension state behind.

## Example Application
For a new agent UI that adds curated plugin sources, apply this pattern whenever sources need to be cloned or updated in the background so the UI gets per-source spinners and the rest of the agent remains responsive.

## Anti-Patterns (What NOT to do)
- Do not block the main thread until marketplace reconciliation finishes; it should happen behind the scenes with status rows.
- Do not start reconciling without seeding the UI state—users must see which marketplaces are pending.
- Avoid treating updates and fresh installs the same way; they often require different downstream actions (live refresh vs. manual refresh notification).

## Source & license

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

- **Author:** [ychampion](https://github.com/ychampion)
- **Source:** [ychampion/cskill-agents](https://github.com/ychampion/cskill-agents)
- **License:** MIT
- **Homepage:** https://x.com/YashasGunderia/status/2039990540016693692?s=20

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-ychampion-cskill-agents-background-marketplace-reconciliation
- Seller: https://agentstack.voostack.com/s/ychampion
- 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%.