LucasSantana-Dev
- 148 skills
- 0 followers
- 1 repo stars
- 2 weeks ago last updated
- ▌ Xp · lucassantana-dev bundleExtreme Programming for AI-human pair development. Use when: pair programming with your AI, building incrementally with tests, working with clear role division, or the user mentions XP/YAGNI/simple design/continuous refactoring.
- ▌ Recall · lucassantana-devSemantic-search personal knowledge (memory, plans, handoffs, skills, Codex rules) via the local RAG index at ~/.claude/rag-index/. Use when a query is fuzzy or cross-file ("how did we fix X", "what did we decide about Y", "which skill handles Z"). Complements grep (exact) and Serena (code symbols). If the user asks a recall question that doesn't map to a specific known file, reach here first.
- ▌ Debug · lucassantana-dev bundleSystematic root-cause analysis for bugs, errors, and unexpected behavior
- ▌ Hotfix · lucassantana-dev bundleComposite skill — emergency bypass of the release branch when production is broken and waiting for the next release-cut is not viable. Chains incident scoping → branch from main (NOT release) → minimal fix → pr-merge-readiness → merge to main → patch-version tag → deploy → cherry-pick to release branch → post-deploy verify (sentry + ci-watch). Use ONLY for production-impacting breakage; routine "small fix" work belongs in /pr-to-release.
- ▌ Spec New · lucassantana-devCreate a committed per-feature spec under `docs/specs/YYYY-MM-DD-<slug>/{spec,tasks}.md` with frontmatter (status, created, owner, pr, tags). Promotes an ephemeral `.claude/plans/<name>.md` into a persistent, searchable artifact. Use when starting a feature that's larger than a one-shot PR.
- ▌ Add · lucassantana-dev bundleMeta-adder for toolkit artifacts. Single entry point to add a skill, pattern, best-practice, hook, agent, or guide with correct frontmatter + sync to 4 publish targets.
- ▌ RAG · lucassantana-dev bundleBuild and debug Retrieval-Augmented Generation pipelines — chunking, embedding, retrieval, reranking
- ▌ Testing · lucassantana-dev bundleTest generation is repetitive but critical. Developers skip tests because writing edge cases is tedious. AI agents can generate tests quickly but often produce brittle, unrealistic tests that provide false confidence. Tests that mock internals, use fake data like "foo@example.com", or test implementation details break on every refactor.
- ▌
- ▌ Cost · lucassantana-dev bundleTrack and report token usage and estimated cost per session, agent, and phase
- ▌ Eval · lucassantana-dev bundleEvaluate LLM outputs systematically — benchmarks, automated metrics, human preference, and regression tracking
- ▌ Loop · lucassantana-dev bundleDefault execution rhythm — inspect → act → verify → checkpoint — applied iteratively until the task is done or a clear blocker emerges. Use when working through a known plan, draining a queue (PRs, issues, dependency bumps), or executing a multi-step recipe where each step's output informs the next. Each iteration must produce a concrete artifact (commit, comment, decision) and a one-line state update. Stop on first unrecoverable error rather than retrying blindly. Pair with `ship` for merge-bound work and `handoff` if budget runs out mid-loop.
- ▌ Plan · lucassantana-dev bundleBuild a compact, validation-gated implementation plan for multi-step, risky, or ambiguous work — typically when phases need explicit checkpoints, the change touches multiple files/services, or the user wants alignment before execution. Output goes to `.claude/plans/<topic>.md` (or `.agents/plans/`) with goal, in/out-of-scope, phased steps, validation per phase, and replanning triggers. Skip for trivial single-file fixes, bug investigations (use `tracer`), or open-ended exploration (use `explore`). Pair with `ship` once the plan ends and merge work begins.
- ▌ Ship · lucassantana-dev bundleCommit, push, and open a pull request with a conventional commit message
- ▌ First Pr · lucassantana-dev bundleComposite skill — land a safe first PR in an unfamiliar repo without rediscovery loops or guessing at conventions. Chains onboard-new-repo (architecture + scripts + CI scan) → context-pack (relevant files + standards + ADRs for the scoped change) → scope-and-execute (narrow the task) → test-driven-development (write failing test first) → pr-to-release (open the PR). Use the first time you contribute to a repo OR when an unfamiliar contributor needs a guided first change.
- ▌ Context Pack · lucassantana-devBuild a task-aware context bundle (relevant code + applicable standards + related past decisions) via the local RAG index, capped at a token budget. Use at the start of any implementation/refactor/debug task instead of reading files blindly. Replaces "read whole file" with "retrieve the function + callers + rules + prior ADR."
- ▌ Learn · lucassantana-dev bundleAuto-extract reusable patterns from the current session into skills or memory
- ▌ Route · lucassantana-dev bundleRoute a task to the most fitting skill or agent. Parses user intent, checks installed-skill inventory, and picks the best match (single skill or chain).
- ▌ MCP Audit · lucassantana-dev bundleRead-only diagnostic that scans Claude Code session transcripts to surface which MCP servers and tools you actually use, ranked by call frequency, with zero-use servers flagged for removal. Use when planning an MCP cleanup, evaluating whether to keep a newly-added server, deciding which servers warrant token cost in the catalog, or before authoring an MCP-removal PR. Outputs a markdown report (last N days) — does not modify any settings. Pair with the manual `claude mcp remove <name>` step once findings are reviewed.
- ▌ Memory · lucassantana-dev bundlePersist decisions, preferences, and project state across sessions using structured memory types
- ▌ Resume · lucassantana-dev bundleRecover session state from git, plans, and open PRs, then continue from the last completed phase without repeating work
- ▌ Secure · lucassantana-dev bundleShortcut for security review on current change set. Runs layered checks (secret-scan, dep-audit, semgrep, OWASP patterns, prompt-injection review).
- ▌ Ticket · lucassantana-dev bundleAssemble a Jira/Linear/GitHub-Issue body from recent commits, diff, and branch context
- ▌
- ▌ Context · lucassantana-dev bundleOptimize context window usage — compact stale data, compress via summarization, preserve active state
- ▌ Ship It · lucassantana-dev bundleComposite skill — take a merged PR all the way to production. Chains version-bump → changelog-update → ship (tag + release) → deployment-automation or vercel-deploy / cloudflare-deploy / prod-rebuild → post-deploy verify (sentry + ci-watch). Distinct from merge-confidently which stops at merge; this one ends with "live in prod, verified, no incidents."
- ▌ Agent Teams · lucassantana-dev bundleDecompose a task into parallel workstreams, assign agent ownership, run integration at dependency boundaries, and synthesize results.
- ▌ Code Review · lucassantana-dev bundleCode review is time-consuming and inconsistent. Reviewers miss security issues, overlook edge cases, or focus on style over substance. Meanwhile, AI agents catch these mechanical issues instantly but can't judge business logic correctness, UX decisions, or architectural fit.
- ▌ Release Cut · lucassantana-dev bundleComposite skill — promote the long-lived `release` branch to `main`, cut a single version that batches every PR accumulated since the last tag, then clean up. Chains pr-merge-readiness (on release→main PR) → version-bump (semver from commits) → changelog-update (promote [Unreleased] → versioned) → ship (tag + GitHub release) → stale-branch cleanup → optional ship-it for deploy. Use this INSTEAD of releasing every small fix individually. Many small commits become one well-scoped release.
- ▌ Sync AI Tools · lucassantana-dev bundleSync Claude Code AI tooling (skills, MCP servers, rules) across Warp, Cursor, and VSCode. Idempotent — safe to re-run. Use when onboarding a new editor, after adding MCP servers, or when standards files change.
- ▌ Warp AI Setup · lucassantana-devConfigure Warp terminal to share Claude Code's MCP servers and AI rules via File-based MCP + AGENTS.md. One-time UI toggles plus file sync. Use when onboarding Warp or after a Warp update resets settings.
- ▌ CI Watch · lucassantana-dev bundleInspect current CI state, identify the first real blocker, separate required failures from noise, and monitor until checks settle. Use when checks are failing, flaky, or blocking a merge.
- ▌ Fallback · lucassantana-dev bundleGraceful degradation when primary approach fails. Try alternates in priority order; record which path succeeded for future routing.
- ▌ Optimize · lucassantana-dev bundleOptimize context usage for the session by reducing bloat, improving token efficiency, and focusing on relevant areas. Use when context is growing large, responses are slow, or switching between unrelated tasks. Covers context analysis, compacting, targeted pruning, MCP-first strategies, and focused scoping by area.
- ▌ Research · lucassantana-dev bundleDeep research on a topic using web search, docs, and codebase analysis
- ▌ Schedule · lucassantana-dev bundleDefine and manage recurring automated agent runs — CI monitoring, dep updates, security scans
- ▌ UI Audit · lucassantana-dev bundleUI/UX design system reference, pattern library, and focused review guidance for web and mobile applications. Use for targeted design research, pattern selection, UX audits, accessibility guidance, palette and typography selection, layout heuristics, and component pattern research. Covers 50+ styles, 97 color palettes, 57 font pairings, Web Interface Guidelines compliance, and concrete visual/usability improvements for modern SaaS and product interfaces.
- ▌ Handoff Diet · lucassantana-dev bundleMeta-skill codifying the no-wakeup-polling pattern. Describes the ScheduleWakeup anti-pattern, the fix (--auto merge + detached watcher), and when to still use wakeups. Reduces handoff spam by 80%.
- ▌ Mac Optimize · lucassantana-dev bundleDiagnose and fix macOS resource pressure for Claude Code workflows. Use when load avg is high, swap is saturated, CC feels slow, or before spinning up parallel agents/worktrees. Covers CPU top-talkers, swap pressure, zombie claude processes, Node heap tuning, Spotlight/background-agent pruning, and purge. Apple Silicon aware.
- ▌ Adr Write · lucassantana-dev bundleCapture an Architecture Decision Record — what was decided, why, what alternatives were considered, and when to revisit. Writes a numbered ADR file to docs/adr/ in the active repo, with consistent formatting that downstream skills (improve-codebase-architecture, refactor-plan) can read. Use right after deciding something non-obvious so the reasoning isn't lost.
- ▌ Build Fix · lucassantana-dev bundleLocal build-error triage. Detects common compile errors and suggests fixes
- ▌ RAG Drift · lucassantana-dev bundleDetect and fix stale chunks (files that changed or were deleted since last indexing)
- ▌ Self Heal · lucassantana-dev bundleAutonomous error recovery — detect failures, diagnose root cause, apply fixes, and resume without stopping
- ▌ Agent Gotchas · lucassantana-dev bundleAI coding agents fail in consistent, predictable ways. They fabricate npm packages that don't exist. They catch errors and continue silently. They add features you never asked for. They lose context mid-session and forget what they were doing.
- ▌ Git Worktrees · lucassantana-dev bundleMultiple AI agent sessions working on the same repository cause chaos. Session A is on branch feature/auth. Session B switches to main to check something. Session A's next tool call fails because the branch disappeared. Or worse: Session B force-pushes over Session A's work.
- ▌ Roadmap Refresh · lucassantana-devRegenerate `docs/roadmap.md` for a repo from all specs under `docs/specs/` + their frontmatter (status, tags, pr). Produces Now/Next/Recently-shipped sections. Run after creating / shipping a spec, or at the start of a new session for orientation.
- ▌ Audit Deep · lucassantana-dev bundleComposite skill — full project health check across testing, config, hooks, performance, security, MCP, and plugins. Runs the audit skills in parallel and reconciles into one severity-ranked report with prioritized remediation plan. Use weekly per active project, before major releases, or as part of quarterly tech-debt review.
- ▌ Checkpoint · lucassantana-dev bundleGit-level WIP safety net. Stashes uncommitted work, tags, and pushes to remote