swiftpostlabs
- 56 skills
- 0 followers
- 6 hours ago last updated
- ▌ Ref Sp JS Deno · swiftpostlabs bundlePortable Deno guidance for modern runtime usage, deno.json configuration, tsconfig and ESLint adoption, permissions, Node interop, and hybrid Deno or Node repositories. Use when: writing Deno code, configuring deno tasks, or adopting Deno into an existing TypeScript or Node repo.
- ▌ Ref Sp JS Next · swiftpostlabs bundlePortable Next.js guidance for App Router structure, client and server boundaries, framework integrations, and Next-friendly library choices. Use when: creating or reviewing Next routes and layouts, deciding where 'use client' belongs, configuring Next.js, or choosing framework-specific integrations like next-intl.
- ▌ Ref Sp Web SEO · swiftpostlabs bundleAudit a website's SEO from what is actually observable — served and rendered HTML, robots.txt, sitemaps, canonicals, titles, structured data, Core Web Vitals — separate that from the performance data only Search Console can answer, and design before/after tests that mean something. Use when: asked to check, audit, or improve a site's SEO; diagnosing why pages are not indexed, not ranking, or why organic traffic dropped; reviewing robots.txt, sitemaps, canonicals, titles, or structured data; debugging why a crawler cannot see JavaScript-rendered content; SEO on Next.js, WordPress, or headless WordPress + Next.js (metadata, sitemaps, canonicals, static export); interpreting a Lighthouse or Core Web Vitals report; judging whether an SEO change actually worked; weighing an SEO claim from a leak, a vendor, or a blog; or assessing content quality against Google's rater framework.
- ▌ Tool Sp Commit · swiftpostlabsInspect edited files, group them into logical commits, and create focused commits. Use when: the user asks to commit changes, split work into focused commits, or decide how the current diff should be grouped before committing.
- ▌ Ref Sp DB Nosql · swiftpostlabsPortable NoSQL guidance for choosing document, key-value, graph, or wide-column models, handling CAP and eventual-consistency tradeoffs, and modeling denormalized access patterns deliberately. Use when: relational joins stop matching the workload, horizontal scale or flexible schema dominates, or a distributed data model is being designed.
- ▌ Ref Sp JS React · swiftpostlabs bundlePortable React guidance for components, hooks, client-side state, and React-friendly library choices. Use when: creating or reviewing React components, choosing React libraries, deciding where UI or async state should live, or refactoring a React feature that is getting hard to read.
- ▌ Ref Sp Py Python · swiftpostlabs bundlePortable Python guidance for typed application code, scripts, CLIs, and tests. Use when: writing or refactoring Python modules, designing Python feature folders, or deciding typing and testing patterns.
- ▌ Ref Sp UX Design · swiftpostlabs bundleDesign what a human sees and operates from evidence rather than taste: Gestalt grouping, visual hierarchy, spacing, typographic scale and measure, emphasis, palette construction in perceptually uniform colour, long-form readability, and mobile-first layout — with every claim labelled as research, standard, convention, or folklore. Use when: designing or reviewing a UI, page, screen, or component; asked why a layout feels off, cluttered, or unbalanced; choosing spacing, margins, padding, or a grid; picking font sizes, line height, or line length; deciding where bold, italic, or capitals belong; building or fixing a colour palette; turning a wall of text into a readable article or blog post; designing mobile-first or choosing breakpoints; or judging a design claim, trend, or 'law of UX' against what the research actually supports.
- ▌ Ref Sp Web SEO AI · swiftpostlabs bundleVisibility in AI answers — Google AI Overviews and AI Mode, and assistants like ChatGPT, Claude, and Perplexity: how they retrieve and cite pages, how to control AI crawler access, how AI surfaces distort your Search Console numbers, and which GEO advice is defensible versus speculative. Use when: asked how to rank, appear, or get cited in AI search, AI Overviews, or chatbots; asked about GEO, AEO, or answer-engine optimization; deciding whether to allow or block AI crawlers (GPTBot, ClaudeBot, Claude-User, PerplexityBot, Google-Extended, CCBot), or whether to opt out of AI training; writing robots.txt rules for AI bots; or diagnosing falling clicks while impressions hold steady.
- ▌ Ref Sp DB Security · swiftpostlabsPortable database-security guidance for threats, access control, views, auditing, encryption, integrity, and secure recovery. Use when: protecting database-backed systems, designing authorization models, reviewing confidentiality, integrity, or availability risks, or securing backups, logs, and administrative access.
- ▌ Ref Sp Agents Hooks · swiftpostlabs bundleAuthor agent lifecycle hooks that run deterministic shell commands at session, prompt, tool, and stop events across Claude Code, GitHub Copilot CLI, VS Code, and Gemini CLI. Use when: creating or editing a hook, choosing a lifecycle event, writing a hook script that reads stdin JSON and returns an allow/deny/context decision, making a hook portable across agents, or debugging why a hook does not fire or block.
- ▌ Ref Sp Agents Retro · swiftpostlabsReference guidance for using `.agents/retro/` as a gitignored local workspace where an agent records a short, descriptive retrospective at the end of a substantial task: what went well, what went wrong and how each problem was solved or worked around, new information learned about the repo or tools, and improvement hypotheses a future agent can weigh when approaching similar work. Use when: finishing a substantial task and capturing a retro, recording how a problem was solved or worked around, noting new facts discovered about the repo or tooling, reading past retros before starting similar work to calibrate an approach, writing or naming a retro entry under `.agents/retro/`, triaging a captured retro from `10-new/` to `90-closed/`, setting its `status`, `created`, `updated`, or prose `outcome` frontmatter, or deciding whether a recurring retro observation should be promoted into a skill or instruction.
- ▌ Ref Sp Agents Policy · swiftpostlabs bundleRepository-specific guidance for the agents-policy feature, .agents/config.json policy section, and generated AI restriction outputs in this repo. Use when: working on the agents-policy feature, updating policy docs, or debugging Copilot, Claude Code, or Gemini policy generation here.
- ▌ Ref Sp Baas Supabase · swiftpostlabs bundlePortable Supabase guidance for CLI workflows, migrations, supabase-js CRUD usage, Edge Functions, and ORM boundaries. Use when: initializing Supabase, evolving schema, designing CRUD paths, writing Edge Functions, or deciding how ORMs fit with Supabase.
- ▌ Ref Sp DB Operations · swiftpostlabsPortable guidance for running a database as a durable system of record: transaction boundaries and ACID, concurrency and isolation, indexing and storage, query optimization, backup and recovery, and safe schema migration. Use when: planning transactions or isolation levels, diagnosing lock contention or a slow query, choosing or pruning indexes, planning a migration or rollback, or reviewing whether backups actually restore.
- ▌ Ref Sp JS Javascript · swiftpostlabs bundlePortable JavaScript guidance for scripts and browser code with JSDoc-based typing. Use when: writing plain JavaScript, adding JSDoc, or keeping JavaScript maintainable without TypeScript.
- ▌ Ref Sp JS Typescript · swiftpostlabs bundlePortable TypeScript guidance for strict typing, runtime boundaries, and maintainable scripts or apps. Use when: writing or reviewing TypeScript code, types, or configuration decisions.
- ▌ Ref Sp JS Userscript · swiftpostlabs bundlePortable guidance for browser userscripts on Tampermonkey, Violentmonkey, and similar managers. Use when: writing or reviewing .user.js or .user.ts scripts, metadata blocks, permissions, or DOM automation.
- ▌ Ref Sp Py Commitizen · swiftpostlabsPython Commitizen release workflow guidance. Use when: configuring commitizen in pyproject.toml, choosing version providers, generating changelogs, validating conventional commits, or designing Commitizen-led release commands for Python or mixed Python/Node repos.
- ▌ Ref Sp Web Marketing · swiftpostlabs bundleMeasure web marketing honestly: why 'Direct' is a bucket of lost origins rather than a channel, how dark social destroys referrer data, when a conversion difference is noise rather than signal, and how to recover attribution you cannot track. Use when: reading a traffic, channel, or conversion report; asked which channel is working or where to spend budget; asked why Direct traffic is so high; interpreting a conversion-rate change, a campaign result, or a traffic spike; setting up UTM tags or self-reported attribution; analyzing analytics from Google Analytics, Wix, Shopify, or similar; or judging whether a marketing claim is supported by the data behind it.
- ▌ Ref Sp Web Wordpress · swiftpostlabs bundleBuild on WordPress correctly: the sanitize-input / check-capability / escape-output security model that prevents most WordPress vulnerabilities, hooks as the extension mechanism instead of editing core, safe database access with prepared statements, child themes, and the REST API for headless frontends. Use when: writing or reviewing a WordPress plugin or theme, handling form or request data in PHP, adding an admin action or AJAX/REST endpoint, querying the WordPress database, deciding how to extend WordPress without modifying core, auditing a WordPress site's security or update posture, or building a headless WordPress backend.
- ▌ Tool Sp Create Skill · swiftpostlabsCreate a new skill using the repo's skill-authoring standard. Use when: the user wants to add a new skill, scaffold a skill folder, turn repeated guidance into a skill, or run a guided wizard before writing skill files.
- ▌ Ref Sp DB Distributed · swiftpostlabsPortable distributed-database guidance for fragmentation, replica placement, local and global applications, parallel DBMS topologies, and disconnected synchronization. Use when: designing distributed or replicated databases, choosing site layout, planning mobile or intermittently connected data flows, or separating topology decisions from data-model decisions.
- ▌ Ref Sp Agents Security · swiftpostlabs bundleReference guidance for agent security policy, protected file access, exclusion sync, and multi-client enforcement. Use when: modifying a policy source file, updating the sync workflow, reviewing generated restriction files, or changing how agents are prevented from reading sensitive files.
- ▌ Ref Sp Dev Git Commits · swiftpostlabsReference guidance for grouping changes into focused commits and writing clear commit messages. Use when: deciding how to split changes into commits, writing a commit title or body, deciding whether a commit needs a long description, or documenting an automated command for reproducibility.
- ▌ Ref Sp DB Schema Design · swiftpostlabs bundlePortable guidance for designing a relational schema end to end: fact-finding and mission scope, conceptual ER/EER modeling, logical derivation and normalization, and physical design driven by the workload. Use when: starting a schema from requirements, turning business rules into entities, keys, and relationships, decomposing a wide table or reviewing functional dependencies and normal forms, deciding how far to normalize or when to denormalize, or reviewing whether a design skipped straight to implementation.
- ▌ Ref Sp JS Next Template · swiftpostlabs bundleApp-level guidance for building a full React and Next.js application. Use when: scaffolding or reviewing a whole React/Next app, choosing the baseline stack and package manager, deciding app-level structure, or comparing a full app against a simpler standalone browser tool.
- ▌ Ref Sp UX Accessibility · swiftpostlabs bundleMake an interface usable by people the design did not assume — using WCAG 2.2 as the normative floor rather than a vibe. Owns every accessibility threshold this repo states: contrast ratios, target sizes, reflow, text spacing, focus visibility, and motion. Use when: checking or fixing accessibility; asked whether a colour pair, tap target, focus ring, or font size passes; auditing a page or component against WCAG 2.2 A/AA/AAA; deciding whether to use APCA or WCAG 2 contrast; adding ARIA, roles, labels, or alt text; choosing between a div and a semantic element, adding landmarks, or fixing heading order; keyboard navigation, focus order, or screen-reader behaviour; handling reduced motion; making content reflow at 320px or survive user text-spacing overrides; or judging an accessibility claim, overlay product, or automated-checker score.
- ▌ Ref Sp Web Social Media · swiftpostlabs bundleDecide whether and how a site or brand should invest in social and video platforms (TikTok, YouTube, Instagram, LinkedIn, X) for organic discovery — separating what the platforms and independent research actually document from the large layer of agency folklore, and measuring it honestly inside walled-garden analytics. Use when: asked whether to be on TikTok/YouTube/Instagram for reach, how discovery or in-app search works on a platform, whether outbound links hurt reach, how younger audiences find things, how social content shows up in Google, or judging a social-strategy claim or agency deck.
- ▌ Tool Sp Maintain Skills · swiftpostlabs bundleReview, consolidate, and update project skills after repo, workflow, or branch changes. Use when: skills may be outdated after code or tooling changes, guidance is duplicated or misplaced, or the repo's skill catalog needs a maintenance pass.
- ▌ Tool Sp Setup Agent Repo · swiftpostlabs bundleAudit a repository against the shared agent baseline — the .agents local workspaces, the core skills and how they are distributed, AGENTS.md as the single source of truth, and per-client bridges — then wire up whatever is missing. Use when: setting up agent tooling in a new or existing repo, checking whether a repo has .agents/tasks, .agents/retro, and .agents/playground gitignored, checking whether the core skills are present and whether the stack needs more, adopting shared skills by vendoring, sync, or marketplace plugin, moving CLAUDE.md or copilot-instructions.md content into AGENTS.md behind a bridge, or wiring a client such as Claude Code, Copilot, Gemini, Cursor, Codex, Hermes, or OpenClaw to the repo's AGENTS.md.
- ▌ Ref Sp Agents Local Setup · swiftpostlabs bundleRun a coding agent against a model on your own hardware: measure the machine, compute whether weights plus KV cache actually fit, choose the right harness class for that budget (tool-calling agent, text-edit-format assistant like Aider, or fill-in-the-middle completion), pick a model that is current rather than remembered, serve it with Ollama, and wire pi or Hermes to it. Includes a dated model table and the commands to refresh it. Use when: setting up or debugging a local LLM for an agent, deciding whether a machine should run an agent, Aider, or inline autocomplete, choosing between Ollama, llama.cpp, and MLX, asking which model a machine can run or whether it can run one at all, sizing VRAM, unified memory, quantization, or context window, checking what models exist right now on ollama.com or Hugging Face, wiring pi, Hermes, or another agent client to a local or OpenAI-compatible endpoint, or diagnosing a local agent that is slow, silent on the first turn, or never calls its tools.
- ▌ Ref Sp Agents Local Tasks · swiftpostlabsReference guidance for using `.agents/tasks/` as a gitignored local workspace: a lightweight `TODO.md` notes list plus date-prefixed tracked task folders that move through the `10-new/`, `20-open/`, and `90-closed/` lifecycle subfolders, each carrying `status`, `created`, `updated`, and (once closed) a prose `outcome` in frontmatter. Use when: reading or updating `.agents/tasks/TODO.md`, creating or moving a tracked task folder between `10-new/`, `20-open/`, and `90-closed/`, setting a task's frontmatter `status` or `outcome`, naming a task folder, or checking whether local agent task notes still match the active work.
- ▌ Ref Sp Dev Docs Authoring · swiftpostlabsPortable README and documentation authoring guidance for top-level and feature-level docs. Use when: writing or restructuring a README, deciding whether user usage or developer setup should come first, adding concrete examples, or splitting long docs into focused follow-up files.
- ▌ Ref Sp Dev Playwright CLI · swiftpostlabs bundleAutomate browser interactions, test web pages, and work with Playwright tests via the playwright-cli terminal tool. Use when: driving a real browser from the command line (open/goto/click/fill/snapshot), debugging a page's console/network/DOM, running or debugging Playwright tests, recording video or traces of a session, or asking the user for live UI/design feedback.
- ▌ Ref Sp Dev Coding Patterns · swiftpostlabs bundlePortable coding defaults for readable, strongly-typed, well-tested code across languages and CLIs. Use when: choosing naming, typing, comments, branching structure, CLI ergonomics, or testing defaults in a new or existing codebase.
- ▌ Tool Sp Setup Local Agents · swiftpostlabs bundleAudit this machine's local-model setup against the local-setup baseline, then wire up what is missing: accelerator memory and the harness class it can serve, the Ollama server's real configuration, whether an installed model can actually do the job, network exposure, and which client is connected. Use when: setting up a local model for a coding agent on a machine, asking whether this machine's local setup is correct or fast enough, checking why a local agent is slow, silent, or not calling tools, reviewing Ollama's context, keep-alive, KV cache, or host binding, choosing between an agent, an Aider-style assistant, and inline autocomplete for the hardware, or wiring pi, Hermes, or another client to a local endpoint.
- ▌ Ref Sp Dev Repo Conventions · swiftpostlabs bundleRepo-specific conventions for this Python project (agentic-tools): the feature-first src/agentic_tools layout, pyproject.toml configuration hub, Black + Pyright-strict + pytest tooling via Poe, typing rules, CLI and script placement, and translations. Use when: creating or moving features, tests, or CLI entrypoints; deciding which top-level or package folder a file belongs in; adjusting pyproject.toml, Poe tasks, or tool config; or explaining how this repo is wired.
- ▌ Ref Sp Dev Github Actions CI · swiftpostlabs bundlePortable GitHub Actions CI guidance for workflow triggers, job design, permissions, matrix strategy, concurrency, caching, and workflow hardening. Use when: creating or reviewing .github/workflows/*.yml files, setting up CI or reusable workflows, or securing workflow tokens, actions, and runner choices.
- ▌ Ref Sp Dev Github Dependabot · swiftpostlabs bundlePortable Dependabot guidance for dependabot.yml configuration, ecosystem selection, schedules, grouping, ignore or allow rules, private registries, and GitHub Actions updates. Use when: creating or reviewing .github/dependabot.yml, tuning update volume, or deciding how version and security updates should be grouped and scoped.
- ▌ Tool Sp Make Skill Shareable · swiftpostlabs bundleReview an existing skill, decide whether it can be made shareable, and update its shareability metadata through a guided workflow. Use when: a skill lacks shareable-skills metadata, a user wants to export or symlink a skill, the current portability is unclear, or a repo-local skill might need to be split into a shared core.
- ▌ Ref Sp Agents Mr Wolf Persona · swiftpostlabsThe Mr. Wolf persona: the agent's voice, directness, and escalation stance — assess before acting, state your understanding before executing, correct wrong premises on sight (including the user's), stay blunt about problems and courteous to people, and report what is actually true rather than what lands well. Carries the canonical persona text that instruction files inline verbatim. Use when: starting or resuming a task, delivering unwelcome technical feedback or pushing back on a flawed premise, refreshing instruction files that must preserve the agent's voice, or adopting this working style in another repo.
- ▌ Ref Sp Dev Package Management · swiftpostlabs bundlePortable package-management guidance for coordinating versions across multiple manifests, keeping changelogs current, and choosing one source of truth for release metadata. Use when: syncing package versions across pyproject.toml and package.json, defining a changelog workflow, or designing a release-management command for a multi-ecosystem repo.
- ▌ Ref Sp Agents Shareable Skills · swiftpostlabs bundleNormative spec for how a repo names, describes, scopes, shares, and vendors skills: owner-prefix naming grammar, the domain registry, visibility tiers, dependency semantics, vendoring vs forking, and the sharing-spec validator. Use when: naming or renaming a skill, setting owner/domain/visibility/tags, recording hard vs soft skill dependencies, vendoring or forking a skill from another repo, or validating a skill for export.
- ▌ Ref Sp Agents Skills Authoring · swiftpostlabs bundleReference guidance for creating and maintaining project skills. Use when: designing new skills, updating existing skills, establishing skill standards, evaluating skill quality, organizing skill subfiles, or adapting copied skill content to the repo's actual stack.
- ▌ Ref Sp Dev Semantic Versioning · swiftpostlabs bundlePortable semantic-versioning guidance for release numbering, prerelease handling, dependency range selection, and package.json dependency fields. Use when: choosing a version bump, reviewing semver compliance, setting npm version ranges, or deciding between dependencies, devDependencies, peerDependencies, optionalDependencies, and overrides.
- ▌ Tool Sp Run Adversarial Review · swiftpostlabs bundleRun an adversarial review of a change: probe the repo, spawn a reviewer separated from the author, and verify the user-selected dimensions (skills consistency, code conformance and scope, security, end-to-end behavior). Use when: the user asks to adversarially review, independently verify, or red-team a change; wants a separate agent to review code, skills, security, or end-to-end behavior before accepting it; or wants a structured review pass over the current diff that does more than a self-check.
- ▌ Ref Sp Agents Skills Management · swiftpostlabs bundleRepository-specific guidance for the skills-management CLI and .agents/config.json skills workflow in this repo. Use when: working on the skills-management CLI, updating skills-management docs, or debugging skill linking and sync behavior in a consuming repo.
- ▌ Ref Sp Agents Adversarial Review · swiftpostlabs bundleReference for adversarial review: verifying a change with a reviewer that is structurally separated from the author, under an opposed find-fault mandate, gated on an objective oracle, across selectable dimensions (skills, code, security, end-to-end behavior). Use when: designing or running a review that a separate agent performs, deciding whether a change is safe to accept, checking code against a repo's own skills and scope, reviewing for introduced security risk, smoke-testing an app end-to-end, or reasoning about why self-review misses defects.
- ▌ Ref Sp Dev Projects Architecture · swiftpostlabs bundlePortable architecture guidance for feature folders, boundaries, shared utilities, and separating product code from maintenance scripts. Use when: deciding where code should live, splitting features, or reviewing repository structure.
- ▌ Ref Sp Agents Plugin Marketplaces · swiftpostlabs bundlePublish a repo's skills as an agent plugin distributed through a plugin marketplace, installable from Claude Code, GitHub Copilot CLI, and VS Code: plugin.json and marketplace.json layout, the manifest detection order that lets one repo serve every client, source types, the skills-path and caching rules, how visibility tiers map onto public/private/local hosting, and how releases and updates actually reach users. Use when: packaging skills as a plugin, creating or hosting a marketplace.json catalog, deciding which skills may be published, targeting Copilot CLI or VS Code users, cutting or versioning a plugin release, or debugging why an installed plugin is missing skills or not updating.
- ▌ Ref Sp JS Web Standalone Template · swiftpostlabs bundleApp-level guidance for standalone HTML, CSS, and JavaScript tools that should run without framework or build-system overhead. Use when: creating or reviewing a whole browser-only app, deciding whether it can stay no-build, or choosing local assets and browser-loadable libraries.
- ▌ Tool Sp Handle Agents Local Tasks · swiftpostlabsRead the local `.agents/tasks/` workspace — the `TODO.md` notes list and the tracked task folders under `10-new/`, `20-open/`, `90-closed/` — choose the next actionable item, and work it through with code changes, validation, folder moves, and status updates. Use when: the user asks to check `.agents/tasks/TODO.md`, continue remaining local tasks, or process the repo's local agent-task backlog.
- ▌ Ref Sp Agents Instructions Authoring · swiftpostlabs bundleGuidance for structuring and maintaining repository instruction files across major agent entry points such as Copilot, Gemini, and Claude. Use when: designing the repo's instruction system, choosing a source of truth, or updating AGENTS.md, GEMINI.md, and .claude/CLAUDE.md together.
- ▌ Tool Sp Maintain Agents Instructions · swiftpostlabsReview and update repository agent instruction files after code, workflow, or skill changes. Use when: AGENTS.md, GEMINI.md, or .claude/CLAUDE.md may be outdated, the skill catalog changed, or a multi-provider repo needs its instruction bridge refreshed.
- ▌ Ref Sp Agents Verification Discipline · swiftpostlabsPortable verification discipline that counters jumping to answers, sycophancy, and overconfidence: enumerate candidate approaches or root causes, route verification by confidence and stakes, prune on evidence, abstain explicitly when nothing can settle a claim. Use when: choosing between approaches or root causes, acting on an unverified claim or assumption, responding when the user challenges or contradicts a conclusion, deciding how much verification a risky or irreversible action needs, or calibrating stated confidence in answers, reviews, and reports.