# Shared Agents Knowledge

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-netgrade-digital-shared-agents-shared-agents-knowledge`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [netgrade-digital](https://agentstack.voostack.com/s/netgrade-digital)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [netgrade-digital](https://github.com/netgrade-digital)
- **Source:** https://github.com/netgrade-digital/shared-agents/tree/main/skills/shared-agents-knowledge
- **Website:** https://netgrade-digital.github.io/shared-agents/

## Install

```sh
agentstack add skill-netgrade-digital-shared-agents-shared-agents-knowledge
```

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

## About

# Shared Agents Knowledge

Path: `$SHARED_AGENTS_HOME` (default: `~/.shared-agents`)

## Automatic sync (always — no user action)

**Every session, first step:** run sync before anything else.

```bash
"${SHARED_AGENTS_HOME:-$HOME/.shared-agents}/scripts/sync.sh" pull
```

Pulls **Core** (`~/.shared-agents`) and **Team** (`~/.shared-agents/team/`) when configured.

- Do not ask the user to sync manually.
- Do not skip because "probably up to date".
- Offline/errors: continue with local files; note only if learnings may be stale.

IDE hooks also pull on session start (Cursor `sessionStart`, Claude `SessionStart`). Agent must still sync if hooks may not have run (subagents, headless).

## Retrieve (before non-trivial tasks)

1. Sync (pull) — always first.
2. Read `team/learnings/index.yaml` for `project`, `domain`, `tags`, `versions`.
3. Grep `team/learnings/approved/` for task keywords.
4. Prefer learnings whose `versions` match the project's stack (exact patch or same MAJOR.MINOR.PATCH line); treat `experimental` confidence as hints.
5. Summarize briefly — do not dump the whole repo.

## Capture (after non-trivial tasks — ask first)

**Always ask** after substantive tasks:

> „Soll ich ein Team-Learning in shared-agents anlegen?"

| User says | Action |
|-----------|--------|
| **Yes** / „ja" / „learning speichern" | Write to team `pending/` (see below) |
| **No** | Do nothing |

Also capture when user explicitly asks anytime.

When writing:

1. Activate skill `capture-learning`.
2. Resolve path: `sa pending path YYYY-MM-DD-short-slug` (see [docs/canonical-paths.md](../../docs/canonical-paths.md) — **never** workspace-relative; not in Core-Repo).
3. Never write directly to `approved/`.
4. Remind user: teammate runs **`sa review`** → `approved/` → then all agents can use it.

For shell commands (install, review, pending push): skill **`sa-cli`** or run **`sa help`**.
## Headless agents (OpenClaw)

Wrap commands with entrypoint (sync then exec):

```bash
"$SHARED_AGENTS_HOME/scripts/agent-entrypoint.sh" 
```

Or first line of agent run: `sync.sh pull`.

## Boundaries

No secrets, API keys, or customer PII in learnings.

## Source & license

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

- **Author:** [netgrade-digital](https://github.com/netgrade-digital)
- **Source:** [netgrade-digital/shared-agents](https://github.com/netgrade-digital/shared-agents)
- **License:** MIT
- **Homepage:** https://netgrade-digital.github.io/shared-agents/

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-netgrade-digital-shared-agents-shared-agents-knowledge
- Seller: https://agentstack.voostack.com/s/netgrade-digital
- 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%.