steveclarke/dotfiles
Overview
This skill creates professional Bruno REST API endpoint configurations with secure authentication, environment setup, and clear documentation. It standardizes collection-level auth, request/response handling, and reusable environment variables so Bruno collections are predictable and safe. Use it to speed up API testing, onboarding, and CI-friendly endpoint maintenance.
How this skill works
It generates Bruno-friendly files and snippets for environments, endpoints, auth blocks, request bodies, query/path params, and scripts. It recommends collection-level bearer auth, secret handling for production, pre-request dynamic data generation, and post-response extraction using bru.setVar()/bru.setEnvVar(). It also provides docs templates and test sequences to validate expected status codes and response shapes.
When to use it
- Setting up a new Bruno collection for API testing
- Creating or standardizing new REST endpoints (CRUD)
- Configuring collection-level authentication and secrets
- Preparing environment-specific configs (local, staging, production)
- Building test sequences and response-extraction scripts
Best practices
- Define auth at collection level (auth: inherit) to follow DRY and simplify maintenance
- Store production secrets in vars:secret and never hardcode API keys in source files
- Use bru.setVar() for ephemeral runtime values and bru.setEnvVar() for persistent environment changes
- Document each endpoint with required/optional fields, validation rules, and example responses
- Organize collections into Environments, Authentication, Resources, and Health folders for clarity
Example use cases
- Create Local.bru with baseUrl and dev apiKey for local testing
- Configure collection-level bearer token and inherit it across create/list/get/update/delete endpoints
- Add pre-request script to generate unique emails and randomIds for test runs
- Post-response script stores created resource ID to run subsequent GET/PATCH/DELETE steps
- Prepare a production environment file with vars:secret and read-only health checks for deployment monitoring
FAQ
Use bru.setVar() for temporary values needed only during a single run (extracted IDs). Use bru.setEnvVar() when you want values persisted across runs and visible in the Environment tab.
How do I handle different auth for a single endpoint?
Only apply individual endpoint auth when it deviates from the collection. Define auth blocks (bearer, basic, headers) inside the endpoint and avoid duplicating secrets in source; reference environment variables instead.
37 skills
This skill fetches secrets and manages 1Password items via CLI, asking for secret references and keeping secrets out of shell history.
This skill helps you manage Superthread tasks and boards via CLI, streamlining project setup, viewing, and updates across spaces.
This skill guides migrating secrets from .env to fnox with 1Password, enabling centralized management and secure automation.
This skill helps teams generate lean vision documents for features by guiding discovery, defining scope, and producing vision, future, and discussion summaries.
This skill guides you through implementing a pre-defined plan in small verified steps, checking codebase alignment before each action.
This skill generates a client-friendly monthly invoice summary by translating Git commits and time sheet notes into clear business-focused bullets.
This skill helps you write clean, modular bash scripts with strict error handling and clear structure for reliable automation.
This skill helps you create Bruno REST API endpoints with proper environment config, authentication, and documentation for reliable testing.
This skill orchestrates the full pre-merge pipeline and creates a PR, saving you time by handling checks, approvals, and docs.
This skill analyzes and refines typography to create clear hierarchy, consistent sizing, and improved readability across interfaces.
This skill improves layout and spacing to create intentional visual rhythm, transforming monotonous grids into balanced, readable compositions.
This skill helps evaluate interface design from a UX perspective, offering actionable critiques on hierarchy, IA, emotion, and usability.
This skill amplifies visual impact in safe designs by applying contextual boldness principles to enhance memorability while preserving usability.
This skill designs and refines onboarding flows to help new users reach value quickly with clear guidance and empty-state optimization.
This skill helps you add moments of joy and personality to interfaces, elevating usability with delightful, brand-consistent micro-interactions.
This skill distills complex designs to their essence, removing clutter to reveal clear, focused interfaces.
This skill collects design context from the project and persists it to your AI config for consistent, long-term guidelines.
This skill analyzes a feature and enhances it with purposeful animations and micro-interactions to improve clarity, feedback, and delight.
This skill helps you identify performance bottlenecks and implement measurable optimizations to speed up loading, rendering, and interactions.
This skill helps you push user interfaces beyond expectations by proposing and selecting ambitious, cinema-like interactions before coding.
This skill performs an adversarial code review loop to critique and fix critical findings before committing, ensuring robust paths and security.
This skill helps you normalize designs to your design system by aligning typography, colors, spacing, and components across features.
This skill helps you reduce visual intensity in bold designs while preserving impact, delivering refined, approachable aesthetics that still communicate
This skill helps you build Rails UI with Kiso components and Tailwind theming, accelerating accessible interfaces and themed layouts in Hotwire apps.
This skill helps you manage dev ports and derived URLs with Outport, ensuring deterministic, non-conflicting ports across worktrees and services.
This skill performs a post-implementation finalize checklist, auto-verifying lint, tests, docs, UI quality, and hygiene to prep for merge.
This skill helps you set up and manage Overmind dev environments, enabling daemonized multi-service orchestration from a single command.
This skill researches how production Rails apps solve architectural problems by examining real code patterns from the Real World Rails repository.
This skill helps you write maintainable StimulusJS controllers by applying SOLID and Better Stimulus patterns for configurable state and declarative
This skill quickly creates a concise goal.md by a brief interview to plan technical tasks, ensuring a single actionable document.
This skill analyzes Rails projects and generates stepwise upgrade reports for Rails 7.0 to 8.1, including deprecations and migration guidance.
This skill prints files on Mac or Linux with sensible defaults, including duplex and black-and-white, and handles markdown via md-to-pdf conversion.
This skill downloads YouTube content including transcripts and audio, enabling transcription, subtitle extraction, and MP3 tagging across playlists.
This skill creates detailed implementation plan documents in three phases, outlining structure, approach, and actionable tasks from technical specs for feature
This skill lets you manage Todoist tasks and projects via MCP using shell commands, enabling quick add, find, update, and complete actions.
This skill helps you build and maintain Ruby CLI tools with Thor and Zeitwerk, guiding patterns, UI, and auto-loading best practices.
This skill helps you extract conversation learnings into reusable skills for future sessions by preserving workflows, patterns, and best practices.
