Agent Skill: build, deploy, and manage apps on apps.pop.ski (npx skills)
Peter McNeil
bd42bf933a
Adds references/client-logging.md covering the new createLogger JS API
(@popski/api-client-runtime), the POST /api/{app}/logs wire contract,
Sentry-trace_id correlation, and context-driven logging via
Logger.with(...). Updates distributed-tracing.md with the new
GET/POST /api/internal/log-level runtime switch, and SKILL.md's
overview + reference table to link it.
Claude-Session: https://claude.ai/code/session_01TsyFAfHpaeK6pA5ZMNhvDs
|
||
|---|---|---|
| references | ||
| README.md | ||
| SKILL.md | ||
popski-platform
An Agent Skill for building, deploying, and managing
static apps on apps.pop.ski — the self-hosted platform behind
pop.ski. Teaches AI coding agents (Claude Code, OpenCode,
Cursor, Copilot, and others) the full lifecycle: Forgejo repo creation,
registry.yaml configuration, the typed SQLite data API (sqlc-generated),
wiring up LLM agents, OpenTelemetry instrumentation, and platform debugging.
Install
npx skills add https://git.pop.ski/peter/popski-platform
Contents
SKILL.md— architecture overview, auth model, typed data API.references/create-app.md— step-by-step app lifecycle.references/design-guide.md— UI/UX design guide, Basecoat UI component library.references/registry-schema.md— fullregistry.yamlfield reference.references/structured-data-api.md— schema.sql/queries.sql, sqlc, wire format.references/agent-api.md— LLM agent HTTP endpoints, SSE events.references/authentication.md— identity resolution (Headscale vs Authentik OIDC).references/forgejo-cli.md— usingfgj/teafor git.pop.ski.references/distributed-tracing.md— OpenTelemetry setup and trace viewing.
Source of truth
This repo is the canonical, standalone copy. It was previously embedded and
served directly from the apps.pop.ski app-registry service; it now lives
here so it installs the normal way via npx skills add <git-url>.