LeoYeAI/agent-master-skills / skills/autoskill
autoskill
VerifiedAnalyzes user-requested Screenpipe history windows to detect repeated research workflows, match existing scientific skills, and stage new skill drafts or composition recipes for review. Requires a reachable Screenpipe HTTP API, normally on localhost:3030. Detection and embedding inference run locally; the selected LLM receives redacted app/title cluster summaries and matched skill descriptions. Use only when the user explicitly asks to analyze their recent work and propose skills.
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 34 B |
| SKILL.md | skill md | 16.5 KB |
| config.yaml | config | 2.1 KB |
| references/api-contracts.md | markdown | 7.4 KB |
| references/https-proxy.md | markdown | 2.2 KB |
| references/screenpipe-config.yaml | config | 1.4 KB |
| scripts/autoskill.py | script | 1.1 KB |
| scripts/backends.py | script | 5.1 KB |
| scripts/cluster.py | script | 1.7 KB |
| scripts/doctor.py | script | 4.5 KB |
| scripts/fetch_window.py | script | 2.8 KB |
| scripts/match_skills.py | script | 1.2 KB |
| scripts/promote.py | script | 1.5 KB |
| scripts/redact.py | script | 1.6 KB |
| scripts/run.py | script | 7.4 KB |
| scripts/synthesize.py | script | 2.7 KB |
references/api-contracts.md
View on GitHub# Autoskill API contract review
Reviewed 2026-09-30. These adapters consume a user's already configured services.
No Screenpipe history was read during maintenance. Tests use invented events,
mock transports, and an ephemeral loopback HTTP fixture. Provider docs and
upstream source checks are not authenticated production verification.
## Screenpipe
Source snapshot: [screenpipe 1e77db8](https://github.com/screenpipe/screenpipe/tree/1e77db8243b6f774d5ba816ca7b2c4e909e24eba), specifically
[search](https://github.com/screenpipe/screenpipe/blob/1e77db8243b6f774d5ba816ca7b2c4e909e24eba/crates/screenpipe-engine/src/routes/search.rs),
[auth middleware](https://github.com/screenpipe/screenpipe/blob/1e77db8243b6f774d5ba816ca7b2c4e909e24eba/crates/screenpipe-engine/src/server.rs), and
[CLI arguments](https://github.com/screenpipe/screenpipe/blob/1e77db8243b6f774d5ba816ca7b2c4e909e24eba/crates/screenpipe-engine/src/cli/mod.rs).
The generated [search reference](https://docs.screenpipe.com/api-reference/search/search-screen-and-audio-content)
is useful but lags source for newer query options. No daemon release was installed,
started, built, or queried in this review.
- `GET /search`: `start_time`, `end_time`, `limit`, `offset`; JSON `data[]` with
tagged `{type, content}` records and `pagination.{limit,offset,total}`.
Autoskill requests `content_type=all`; advances by the raw row count, including
skipped rows, until the total is reached. A fixed historical end time reduces
drift, but limit/offset pagination is not an atomic snapshot; capture, backfill,
or deletions can still change a running query. Narrow and rerun inconsistent windows.
- Explicit `include_cloud=false`, `include_frames=false`, `filter_pii=false` keep
this query from requesting cloud results, images, or remote PII processing.
Source describes `filter_pii` as enclave-backed, so do not enable it to achieve
a supposedly local redaction pass. Already synced records present in the local
database may still be searchable; configure Screenpipe itself separately.
- OCR/UI records use `timestamp`, `app_name`, `window_name`, `text`; input rows
use `window_title`/`text_content`; audio can use `transcription` and has no app.
Null optional strings normalize to empty strings. Memory records have creation
times rather than activity timestamps; they and other non-timeline variants
are skipped with a warning, not treated as screen sessions.
- Auth-enabled `/search` requires `Authorization: Bearer <local API token>`,
including loopback. CLI comments about an unconditional localhost exemption
are stale relative to actual middleware. `screenpipe auth token` resolves the
local API key, not the separate cloud-session JWT. Some older/custom daemons
can disable authentication; the client can omit its token in that case.
- `GET /health` is public. `doctor` checks reachability only and never probes
`/search`; it does not prove credentials, capture permissions, or event flow.
- Capture exclusions use repeated `--ignored-windows` substring patterns,
optionally `App::Title`. The bundled YAML is a checklist, not a daemon config.
Do not claim that the prior invented `ignored_apps`/`content_types` keys or
wildcard-wrapped titles protect captured data.
## LM Studio
[Chat Completions](https://lmstudio.ai/docs/developer/openai-compat/chat-completions),
[model list](https://lmstudio.ai/docs/developer/openai-compat/models),
[authentication](https://lmstudio.ai/docs/developer/core/authentication),
[model loading](https://lmstudio.ai/docs/cli/local-models/load).
- Base `http://localhost:1234/v1`; `POST /chat/completions` appends to that base
(actual path `/v1/chat/completions`). Body includes the exact server model ID,
one user message, and `stream=false`; read `choices[0].message.content`.
Truncated, tool-call, non-text, or missing/null `finish_reason` responses fail
instead of becoming drafts.
- LM Studio 0.4.0+ can require `Authorization: Bearer <API token>`.
Set `LM_API_TOKEN` for both `/models` preflight and chat calls.
- `GET /v1/models` returns `data[].id`. With JIT loading, listed models need not
be loaded. `doctor` verifies visibility of the selected ID, not generation,
available memory, context capacity, or completion quality.
- `lms load` and `lms server start` are separate actions. The `autoskill-local`
identifier is a user-assigned alias, not a claim that a model was installed.
Choosing another model or a smaller context is a user setup decision.
## Anthropic and Microsoft Foundry
[Messages](https://platform.claude.com/docs/en/api/messages/create),
[model lifecycle](https://platform.claude.com/docs/en/about-claude/model-deprecations),
[Foundry API](https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/use-foundry-models-claude).
- Anthropic: `POST https://api.anthropic.com/v1/messages`, `x-api-key`,
`anthropic-version: 2023-06-01`, JSON `model`, `max_tokens=4096`, `messages`.
Opus 4.7 remains an active model in the reviewed lifecycle table; this review
does not silently migrate the user's configured model.
- Responses contain typed `content` blocks, potentially including thinking.
Collect only `type=text` blocks, preserving their order. Reject non-final stop
reasons (including `max_tokens`, `tool_use`, and `pause_turn`), missing/null
`stop_reason`, and empty text. Non-streaming replies require a final stop reason.
A normal stop is still not proof that generated SKILL.md satisfies the spec.
- Foundry API-key mode uses base
`https://<resource>.services.ai.azure.com/anthropic`, appending `/v1/messages`;
same `x-api-key` and version header. `model` means deployment name. Generic
gateways must implement this contract. No OpenAI-style endpoint is implied.
Entra bearer acquisition is not implemented; Entra-only models are unsupported
by this adapter. Cloud `doctor` checks configuration/key presence only.
- Requests are synchronous, single-response calls, so there is no completion
pagination. HTTP failures propagate without automatic paid retries. No paid
requests or real credentials were used to verify these adapters.
## Local embeddings and TLS
[SentenceTransformer API](https://sbert.net/docs/package_reference/sentence_transformer/model.html)
was checked against sentence-transformers 6.1.0 release metadata. Construction
accepts `local_files_only`; `encode(str)` returns an embedding usable by the
existing cosine ranking. The
[all-MiniLM-L6-v2 model card](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2)
documents 384 dimensions and truncation at 256 word pieces. Runtime tests use a
stub embedder; no learned weights or scientific matching quality were validated.
The index now parses YAML so folded descriptions and nested credential metadata
do not replace the skill's top-level name/description.
HTTPX 0.28.1 uses verified HTTPS and accepts `SSL_CERT_FILE` for a custom CA.
[Caddy local HTTPS](https://caddyserver.com/docs/automatic-https) does not guarantee
its CA is trusted by every Python environment. See [proxy setup](https-proxy.md).
The final-response checks also follow the provider SDK schemas:
[Anthropic Message](https://github.com/anthropics/anthropic-sdk-python/blob/main/src/anthropic/types/message.py)
requires a non-null stop reason outside streaming; the
[Chat Completion choice schema](https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion.py)
requires a finish reason. Missing fields in mocks are not evidence of a valid
finished production response.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |