arielperez82
@arielperez82
Public Skills
newsletter-assembly
by arielperez82
Assemble selected stories, poll, and show notes into a complete newsletter
script-to-article
by arielperez82
Transform raw teleprompter scripts, video transcripts, and show outlines
standup-context
by arielperez82
Data-gathering scripts for sync/standup reviews, reducing tool calls
knowledge-capture
by arielperez82
'Guides capture, classification, and routing of institutional knowledge
refactoring-agents
by arielperez82
Guides ecosystem-level refactors of agents in this repo. Use when agents
agent-intake
by arielperez82
'Use when evaluating, incorporating, or adding external agents to the
convening-experts
by arielperez82
Convenes expert panels for problem-solving. Use when user mentions panel, experts, multiple perspectives, MECE, DMAIC, RAPID, Six Sigma, root cause analysis, strategic decisions, or process improvement.
exploring-data
by arielperez82
Exploratory data analysis using ydata-profiling. Use when users upload
ticket-management
by arielperez82
Issue tracking strategy, project configuration, query patterns, workflow
orchestrating-agents
by arielperez82
Orchestrates parallel API instances, delegated sub-tasks, and multi-agent
waste-identification
by arielperez82
Waste Snake practice for making process waste visible through continuous observation. Use when any agent or human encounters frustration, tedium, delays, or low-value work during development. Provides the observation format, Lean waste taxonomy reference, and review process for aggregating observations into actionable patterns.
wiki-documentation
by arielperez82
Wiki-based documentation strategy, space architecture, template libraries,
brainstorming
by arielperez82
"You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation."
creating-agents
by arielperez82
Guide for designing and writing agent specifications in this repo. Use
versioning-skills
by arielperez82
REQUIRED for all skill development. Automatically version control every
accessibility
by arielperez82
Audit and improve web accessibility following WCAG 2.1 guidelines. Use
iterating
by arielperez82
Multi-conversation methodology for iterative stateful work with context
docs-seeker
by arielperez82
'Search technical documentation using executable scripts to detect query
problem-solving
by arielperez82
Apply systematic problem-solving techniques for complexity spirals (simplification
extracting-keywords
by arielperez82
Extract keywords from documents using YAKE algorithm with support for
sequential-thinking
by arielperez82
Apply structured, reflective problem-solving for complex tasks requiring
crafting-instructions
by arielperez82
Generate optimized instructions for Claude (Project instructions, Skills,
agile-coach
by arielperez82
Agile Coach for agile software development teams. Use for iteration planning,
editorial-voice-matching
by arielperez82
Match article output to a target publication's editorial voice using a
reader-clarity
by arielperez82
Evaluate and improve editorial content readability using Flesch-Kincaid
bias-screening
by arielperez82
Detect editorial bias across 6 categories (loaded language, partisan framing,
story-selection
by arielperez82
Evaluate and rank candidate stories for newsletter inclusion using 5
artifacts-builder
by arielperez82
Suite of tools for creating elaborate, multi-component HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
doc-coauthoring
by arielperez82
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
asking-questions
by arielperez82
Guidance for asking clarifying questions when user requests are ambiguous, have multiple valid approaches, or require critical decisions. Use when implementation choices exist that could significantly affect outcomes.
agent-browser
by arielperez82
Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.
algorithmic-art
by arielperez82
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
find-skills
by arielperez82
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
api-design-principles
by arielperez82
Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.
skill-creator
by arielperez82
Guide for creating effective skills. Use when users want to create a new skill (or update an existing skill) that extends the agent's capabilities with specialized knowledge, workflows, or tool integrations.
skill-intake
by arielperez82
This skill should be used when evaluating, sandboxing, or incorporating new skills into a project's skill pipeline. Trigger when the user mentions "intake skill", "add new skill", "evaluate skill", "incorporate skill", "skill pipeline gap", or discusses discovering and integrating external or from-scratch skills.
agent-cost-optimization
by arielperez82
Framework for analyzing agent telemetry data to optimize cost, token usage, and model tier selection. Use when tuning agent configurations, reviewing agent costs, selecting model tiers, or interpreting optimization_insights/cost_by_model/agent_usage_summary pipe outputs.
agent-md-refactor
by arielperez82
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
senior-project-manager
by arielperez82
Senior Project Manager for Software, SaaS, and digital web/mobile applications.
actionlint
by arielperez82
Actionlint static analysis for GitHub Actions workflow files. Use when a repo has .github/workflows/ and you need to lint, validate, or set up pre-commit/CI checks for workflow YAML.
agent-optimizer
by arielperez82
"Optimizes agent definitions for responsibility precision, retrieval efficiency, collaboration completeness, classification alignment, and example quality. Use when optimizing an agent, reviewing agent efficiency, agent quality audit, bloated agent, or post-creation/post-intake agent review. Triggers: optimize agent, review agent, agent efficiency, agent quality, bloated agent."
skill-optimizer
by arielperez82
Optimizes existing Claude Code skills for token efficiency using layered loading, content classification, and progressive disclosure. Use when optimizing skills, reducing token usage, reviewing skill efficiency, refactoring large/bloated SKILL.md files, auditing a skill repo for optimization opportunities, or when user mentions skill optimization, skill review, reduce tokens, skill efficiency, or bloated skill. Invoked during skill creation (post-create optimization), skill intake (post-adapt/add optimization), or standalone skill review.
acceptance-test-design
by arielperez82
BDD outer-loop methodology for acceptance tests - walking skeleton strategy, driving-port-only testing, business language purity, and design mandates that connect to the TDD inner loop
research
by arielperez82
Use when you need to research, analyze, and plan technical solutions that are scalable, secure, and maintainable.
markdown-documentation
by arielperez82
Use when writing technical documentation, READMEs, or project documentation in markdown. Covers structure, conventions, and best practices.
markdown-syntax-fundamentals
by arielperez82
Use when writing or editing markdown files. Covers headings, text formatting, lists, links, images, code blocks, and blockquotes.
markdown-tables
by arielperez82
Use when creating or formatting tables in markdown. Covers table syntax, alignment, escaping, and best practices.
mermaid-diagrams
by arielperez82
Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams (domain modeling, object-oriented design), sequence diagrams (application flows, API interactions, code execution), flowcharts (processes, algorithms, user journeys), entity relationship diagrams (database schemas), C4 architecture diagrams (system context, containers, components), state diagrams, git graphs, pie charts, gantt charts, or any other diagram type. Triggers include requests to "diagram", "visualize", "model", "map out", "show the flow", or when explaining system architecture, database design, code structure, or user/application flows.
updating-knowledge
by arielperez82
Systematic research methodology for building comprehensive, current knowledge on any topic. Requires web_search tool. Use when questions require thorough investigation, recent developments post-cutoff, synthesis across multiple sources, or when the agent's knowledge may be outdated or incomplete. Triggered by "Research", "Investigate", "What's current on", "Latest info on", complex queries needing validation, or technical topics with recent changes.