# Hk Scout Wiki

> Run a scout wave over outside sources (links, blogs, trending repos) into a progressive-disclosure research wiki in the current project, then distill findings into the project's ideas/backlog file. Generic across projects. Use when the user shares links/blogs to research, asks to "scout", "build a wiki from these", or wants outside ideas funneled into planning. Triggers on - 'scout wave', 'wiki s…

- **Type:** Skill
- **Install:** `agentstack add skill-deepklarity-harness-kit-hk-scout-wiki`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [deepklarity](https://agentstack.voostack.com/s/deepklarity)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [deepklarity](https://github.com/deepklarity)
- **Source:** https://github.com/deepklarity/harness-kit/tree/main/.claude/skills/hk-scout-wiki

## Install

```sh
agentstack add skill-deepklarity-harness-kit-hk-scout-wiki
```

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

## About

# Scout wave → wiki → ideas (project-agnostic)

Three phases. Phases 1-2 are cheap (haiku); phase 3 needs judgment (sonnet
or the main conversation). The wiki is evidence; the ideas are the product.

## Phase 0 — Discover the project (once per session)

- Wiki root: existing `docs/wiki/` (or wherever a wiki README already
  lives). None yet → create `docs/wiki/README.md` with: a category table,
  the entry format below, and grep/tag conventions. Never a second format.
- Project context: read the project's CLAUDE.md / roadmap / ideas file to
  learn (a) what the system IS in one line, (b) the named areas/buckets/
  themes work is organized under, (c) where distilled ideas belong (an
  IDEAS/BRAINSTORM file, a backlog, or — if none — propose one). If the
  project defines a writing tone doc, read it and obey it.

## Entry format (uniform, always)

```markdown
# 
source: 
author:   |  fetched:   |  status: read | unreachable
tags: 

**One line.** 

## TL;DR
3-6 plain sentences.

## Key ideas
Self-contained bullets.

## Project hooks
Where this touches THIS project: named areas, files, contradictions worth
arguing about. Honest "nothing yet" allowed.
```

## Phase 1 — Scout (parallel haiku agents)

1. Partition sources into batches of 4-8 by theme; each theme is a wiki
   category directory with its own `TOC.md`. Whole-blog surveys go in
   `sources/` (survey = recurring theses + best posts, one line each).
2. Launch ALL batches as parallel haiku general-purpose agents in ONE
   message. Every prompt includes: the entry format verbatim, the fetch
   list, the project-context line from Phase 0, the unreachable rule
   (retry once, then write the entry with `status: unreachable` — NEVER
   invent content), and the order to write the category `TOC.md`
   (`- [title](file.md) — one line. tags: ...`).
3. No explicit link list ("trending X")? One haiku agent with WebSearch
   builds the URL list first; then partition.

## Phase 2 — Assemble (main conversation, minutes)

- Spot-check 2-3 entries for format drift; fix entries, not the format.
- Ensure every category TOC exists and its links resolve; write any TOC a
  scout couldn't own (shared directories).
- Commit the wiki separately from the distillation.

## Phase 3 — Distill (one sonnet agent, or main conversation)

Read the new entries' TL;DR + hooks (not the sources again) and append to
the project's ideas file, in that file's existing structure and tone:

- One paragraph per idea, graded honestly against where the project
  stands, citing the wiki entry, naming the area it would move.
- Contradictions with the project's philosophy are wanted — state them
  plainly and why the outside view might be right.
- Distillation means "what should WE do", never "what did they say".

## Cost discipline

Scouts read the web, not the repo. Distillation reads the wiki, not the
web. Nothing here needs opus. ~30 links ≈ one mid-size task execution.

## Source & license

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

- **Author:** [deepklarity](https://github.com/deepklarity)
- **Source:** [deepklarity/harness-kit](https://github.com/deepklarity/harness-kit)
- **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-deepklarity-harness-kit-hk-scout-wiki
- Seller: https://agentstack.voostack.com/s/deepklarity
- 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%.