jankneumann
@jankneumann
Public Skills
plan-feature
by jankneumann
"Create OpenSpec proposal with tiered execution (coordinated / local-parallel / sequential)"
project-context-refresh
by jankneumann
"Deterministic generate/check producers for documentation, API contracts, decisions, and OpenSpec projections over the ri-06 ProducerResult contract"
debugging-and-error-recovery
by jankneumann
Guides systematic root-cause debugging with the Stop-the-Line rule and a reproduce → localize → reduce → fix → guard → verify triage checklist. Use when tests fail, builds break, behavior doesn't match expectations, or you encounter any unexpected error. Trigger phrases: "test is failing", "build is broken", "I'm seeing an error", "find the root cause", "git bisect", "regression", "stop the line".
context-engineering
by jankneumann
Curates the right context for an agent at the right time. Loaded by orchestrator skills (plan-feature, implement-feature, validate-feature) when a worker is about to start a task and needs to decide which rules, specs, source files, errors, and conversation history to surface. Covers the 5-level context hierarchy, named packing strategies, and the most common failure modes (starvation, flooding, stale context, missing examples, implicit knowledge, silent confusion). Tied to this repo's coordinator, work-packages.yaml scope rules, worktree branching, and OPENSPEC_BRANCH_OVERRIDE handoff conventions.
collect-transcripts
by jankneumann
Ingest raw session transcripts from coding-agent harnesses via vendor-specific adapters, normalize to a common event schema, triage for struggle signals, and write structured findings to episodic memory
changelog-version
by jankneumann
Generate changelog entries and suggest semantic version bumps from git history
langfuse
by jankneumann
One front door for Langfuse — combines the Langfuse Agent Skill (best practices + docs), the Langfuse CLI (full API surface via npx), and the Langfuse MCP server (native prompt-management tool calls). Use when instrumenting an app, querying or modifying Langfuse data (traces, prompts, datasets, scores, sessions, evals), looking up Langfuse documentation, or configuring Langfuse for a new repo. Routes between Skill knowledge / CLI / MCP based on intent.
expedite
by jankneumann
Readiness gate for sync-point operations — inspect validation, rework, and active-agent state before merge
archive-roadmap
by jankneumann
"Archive a completed roadmap workspace to openspec/roadmaps/archive/<date>-<id>/"
coordinator-task-status-renderer
by jankneumann
"Render and seed coordinator-owned task status block in OpenSpec tasks.md"
documentation-and-adrs
by jankneumann
Write durable documentation that captures why a system is the way it is. Use when making a significant architectural decision, adding or changing a public API, shipping user-facing behavior, onboarding new humans or agents, or any time you find yourself explaining the same thing twice. Covers the ADR template (Status / Context / Decision / Consequences), ADR lifecycle (PROPOSED → ACCEPTED → SUPERSEDED → DEPRECATED), sequential numbering, the "comment intent not mechanics" rule, and a README skeleton (quick-start / commands / architecture). Localized to this repo's docs/decisions/ capability-timeline format and OpenSpec workflow.
obsidian-cli
by jankneumann
Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their Obsidian vault, manage notes, search vault content, perform vault operations from the command line, or develop and debug Obsidian plugins and themes.
obsidian-markdown
by jankneumann
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.
gen-eval
by jankneumann
Run generator-evaluator testing against live services
gen-eval-scenario
by jankneumann
Create gen-eval scenario YAML files interactively
agent-metrics
by jankneumann
Generate throughput and quality reports from coordinator audit data and episodic memory
api-and-interface-design
by jankneumann
Guides stable API and interface design for REST endpoints, GraphQL schemas, module boundaries, and component contracts. Use when designing new APIs, defining type contracts between modules, establishing boundaries between frontend and backend, or modifying existing public interfaces. Covers Hyrum's Law, contract-first design, the One-Version Rule, REST resource patterns, pagination, PATCH semantics, and idiomatic type-system patterns in both TypeScript (discriminated unions, branded types) and Python (Pydantic discriminated unions, NewType branded types, FastAPI route shapes, frozen dataclasses).
browser-testing-with-devtools
by jankneumann
Tests in real browsers via Chrome DevTools MCP. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests, profile performance, or verify visual output with real runtime data. This is an infrastructure skill loaded by other testing/debugging skills; it is not directly user-invocable. Trigger phrases (when called by another skill): "verify in the browser", "capture console errors", "screenshot the page", "profile Core Web Vitals", "inspect the DOM".
performance-optimization
by jankneumann
Optimizes application performance with the MEASURE → IDENTIFY → FIX → VERIFY → GUARD workflow. Covers frontend Core Web Vitals (LCP ≤ 2.5s, INP ≤ 200ms, CLS ≤ 0.1), bundle budgets, and React re-render hygiene, PLUS backend latency budgets, Postgres/MySQL EXPLAIN ANALYZE workflows, N+1 query detection, connection-pool sizing, and async profiling with py-spy / cProfile. Use when performance requirements exist, when Core Web Vitals or p95 latency miss thresholds, or when profiling reveals bottlenecks that need fixing.
frontend-ui-engineering
by jankneumann
Builds production-quality, accessible, performant user interfaces. Applies to React/TypeScript frontends — verify stack before invoking; teams using other stacks should treat the principles (state-management ladder, AI-aesthetic avoidance, WCAG 2.1 AA) as transferable but the code patterns as React-specific. Use when building or modifying user-facing components, managing UI state, implementing layouts, or when output needs to look hand-built rather than AI-generated.
deprecation-and-migration
by jankneumann
Manage the lifecycle of removing systems, APIs, features, and dependencies. Use when sunsetting a capability, replacing one implementation with another, consolidating duplicates, killing zombie code, or planning the eventual deprecation of something new at design time. Covers the Churn Rule (owners fund migration cost), the strangler / adapter / feature-flag patterns, the five-question decision matrix, advisory-vs-compulsory deprecation, and how to drive it through an OpenSpec change.
claimable-postgres
by jankneumann
Provision instant temporary Postgres databases via Claimable Postgres by Neon (neon.new) with no login, signup, or credit card. Supports REST API, CLI, and SDK. Use when users ask for a quick Postgres environment, a throwaway DATABASE_URL for prototyping/tests, or "just give me a DB now". Triggers include: "quick postgres", "temporary postgres", "no signup database", "no credit card database", "instant DATABASE_URL", "npx neon-new", "neon.new", "neon.new API", "claimable postgres API".
neon-postgres
by jankneumann
Guides and best practices for working with Neon Serverless Postgres. Covers getting started, local development with Neon, choosing a connection method, Neon features, authentication (@neondatabase/auth), PostgREST-style data API (@neondatabase/neon-js), Neon CLI, and Neon's Platform API/SDKs. Use for any Neon-related questions.