area-lessons
Use this skill when the operator wants to see the active lessons learned by earlier headless runs for the directory they are working in, pulled on demand from the local swarmery daemon. Read-only. Don't use it to accept, edit or promote lessons (that is the daemon's Lessons page) or to search code (use code-search).
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-11
- Stars
- ★ 8
- Forks
- 5
01 前言 Front Matter
- docs
- { "status": "draft", "updated": 1790121600000 }
- name
- area-lessons
- color
- teal
- owner
- swarmery-core
- version
- 1.0.0
- description
- Use this skill when the operator wants to see the active lessons learned by earlier headless runs for the directory they are working in, pulled on demand from the local swarmery daemon. Read-only. Don't use it to accept, edit or promote lessons (that is the daemon's Lessons page) or to search code (use code-search).
- allowed-tools
- Bash
- disable-model-invocation
- true
03 SKILL.md 正文
Purpose
List the ACTIVE lessons whose area globs overlap the current directory, read
from the local swarmery daemon (GET /api/lessons?status=active&area=<dir>).
Headless phase and plan runs already receive these lessons in their prompt;
interactive sessions get them only when the operator asks, through this skill.
Nothing here writes a file, a memory entry, or a hook.
Rules (never violate)
- Read-only: one
curlGET against the daemon onlocalhost:7777, nothing else that changes state. - Never copy lessons into
MEMORY.md,CLAUDE.md, settings, or any hook. A lesson that belongs inCLAUDE.mdis promoted from the daemon's Lessons page, which commits it on a new branch for review. - Quote each lesson with its id (
[L-12]), so a later reply can cite the one it relied on. - When the daemon is not reachable, say so in one line and stop. Never guess lessons.
Procedure
- Resolve the directory relative to the repository root:
git rev-parse --show-prefix(empty at the root; then use.). - Query the daemon, URL-encoding the directory:
curl -s --globoff "http://localhost:7777/api/lessons?status=active&area=<dir>" - Render
lessons[]as one line each,- [L-<id>] <guidance> (areas: <areaGlobs>), newest first as returned. An empty list is a valid answer: "No active lessons for<dir>."
How to use
What it does
Shows the lessons that earlier headless runs in this project learned about the directory you are in: one line per lesson with its citable id, its guidance and the areas it applies to. It reads them from the local daemon and changes nothing. The same matcher decides which lessons a headless run receives.
When to use it
- You are about to work by hand in a directory that headless runs touched before, and want what they learned.
- You want to check which lessons a phase in this area would be handed.
Not for reviewing, accepting, retiring or promoting lessons: that is the daemon's
Lessons page. Not for code search either (code-search).
How to invoke
Skill(skill: "core:area-lessons")
No arguments: it uses the current directory. Name another directory in plain
words to look there instead, for example "lessons for internal/<pkg>".
Worked example
Working in apps/<mainApp>/src/orders, the skill resolves the prefix, calls
/api/lessons?status=active&area=apps/<mainApp>/src/orders, and prints:
- [L-12] Read the line-items schema before writing an orders migration. (areas: apps/<mainApp>/src/orders/**)
Cite [L-12] in your reply if you act on it.
Related
code-search— find the code the lesson talks about.workspace-plans— plan docs whose## Forecastareas decide which lessons a headless run is handed.
04 同仓库更多 Skills
short-desc
Too short.
no-frontmatter
暂无简介
global-skill
Fixture global skill (minimal user-scope shape, format doc §2.3).
documented-skill
Fixture skill whose usage guide deliberately omits the Worked example subsection.
z
NOT auto-discovered — only skills/ is scanned for plugins (§2.2).
y
Plugin skill y from toolpack — stored as "toolpack:y".