Claude Skills by paulasilvatech

Use when editing Backstage integrations with GitHub, Azure, Azure DevOps, or other external providers.

Migrate Backstage app or plugin UI from Material-UI to Backstage UI with version-checked component mappings, CSS setup, accessibility, analytics, styling, and visual validation. Use when replacing @material-ui imports, MUI icons, makeStyles, or adopting BUI.

Migrate Backstage plugins from Material-UI (MUI) to Backstage UI (BUI). Use this skill when migrating components, updating imports, replacing styling patterns, or converting MUI components to their BUI equivalents.

Migrate a Backstage backend plugin from a hand-written Express router to the repository's typed OpenAPI server tooling while preserving routes, auth, permissions, errors, tests, and optional client generation. Use when onboarding createOpenApiRouter or modernizing a router with OpenAPI.

Use this skill when the user wants to migrate an existing Backstage backend plugin's hand-written Express router to the typed OpenAPI tooling. Optionally, can also add typed client generation and migrate router tests to the OpenAPI test wrapper.

Instrument Backstage frontend plugins with meaningful Analytics API events and tests while avoiding duplicate BUI navigation events or UI noise. Use when adding or reviewing captureEvent, AnalyticsContext, event taxonomy, noTrack overrides, or analytics behavior.

Instrument a Backstage frontend plugin with analytics events using the Backstage Analytics API. Use this skill when adding, reviewing, or extending event capture (`captureEvent`, `AnalyticsContext`) in plugin components, deciding whether an interaction warrants an event, or writing tests for analytics behavior.

Plan, architect, scaffold, validate, and prepare custom Backstage plugins and modules using official Backstage documentation. Use when the user asks for new, legacy, or dual frontend plugins, backend plugins, backend modules, catalog processors, entity providers, scaffolder actions, search collators, auth providers, permission policies, TechDocs addons, common packages, node packages, plugin ADRs, architecture, validation, or community publication preparation.

Fully migrate a Backstage frontend plugin to the new frontend system and remove legacy support. Use when performing internal or intentionally breaking migrations from createPlugin to createFrontendPlugin, new route refs, blueprints, PageLayout, and legacy dependency removal.

Fully migrate a Backstage plugin to the new frontend system, dropping all old system support. Use this skill for internal plugins that only need to run in a single app, or when you are ready to remove backward compatibility entirely.

Add new frontend-system support to an existing Backstage plugin while retaining its legacy entry point. Use when published or shared plugins need dual compatibility, alpha exports, PageBlueprint extensions, route reuse, and both old and new app consumers.

Add new frontend system support to an existing Backstage plugin while keeping the old system working. Use this skill for published or shared plugins that need to work in both old and new frontend system apps.

Use when editing Backstage Software Templates or generated skeletons that require safe, portable scaffolding.

Use when editing tracked TechDocs configuration, annotations, navigation, or publication settings.

Validates Open Horizons architecture Markdown documents for required sections, required diagrams, Mermaid structure, explanation completeness, and repository copy conventions. Use this skill when reviewing or finishing an architecture document, checking {app}_Architecture.md, verifying Mermaid diagrams, or confirming the architecture Definition of Done.

Select, explain, and apply cloud design patterns for distributed systems across reliability, performance, messaging, architecture, deployment, security, and event-driven categories. Use when designing, reviewing, or implementing cloud workloads and distributed system architectures.

Requires routing, canonical paths, freshness evidence, frontmatter, tool-token, mirror, and validation conventions when editing Copilot primitives. Use when authoring or reviewing primitives, templates, or installed mirrors.

Create a new repository-root llms.txt file from repository structure and documentation according to the llms.txt specification. Use when users ask to create llms.txt, generate LLM navigation, document repository structure for LLMs, or add an llms.txt compliant with https://llmstxt.org/.

Use when editing the tracked Backstage agent or MCP Docker Compose development stacks.

Use when editing tracked Backstage, agent, MCP, or Golden Path Dockerfiles.

Foundry agent blueprint maps agent designs to Azure AI Foundry Agent Service models, connections, tools, memory, evaluation, and tracing. Use this skill when designing Foundry agent runtimes, model catalog choices, Azure AI Search or Redis connections, Bing connections, OpenAPI tools, MCP tools, code interpreter, file search, threads, runs, or evaluation plans.

Use when cutting a Python release for the microsoft/agent-framework monorepo. Triggers on "bump py versions", "cut a python release", "prepare release PR for python", "release py packages", "bump python to X.Y.Z", or similar requests to bump Python package versions and prepare a release PR. Handles all four lifecycle tiers (alpha, beta, rc, released) with CHANGELOG-driven selective bumps, floor bound checks, and post-bump validation.

Create, register, deploy, update, and synchronize prompt-based Azure AI Foundry agents from a local JSON manifest using the Agent Service REST API. Use when users ask to sync Foundry agents, create agents in Foundry, push agents, update agent instructions, scaffold a foundry-agents.json manifest, or add sync scripts.

Design evaluator-optimizer, reflection, rubric, LLM-as-judge, and test-driven refinement loops for AI agent outputs. Use when implementing self-critique, iterative improvement, quality gates, agent response evaluation, code refinement, or rubric-based scoring for generated code, reports, or analysis.

Azure AI Foundry operations provisions workspaces, model deployments, RAG resources, operational settings, and resource checks. Use this skill when provisioning AI Foundry, deploying OpenAI models, configuring RAG, operating model endpoints, setting up AI workspaces, or checking Foundry resources.

Designs, implements, reviews, and migrates Claude API integrations using official Anthropic SDKs or Claude models in Microsoft Foundry. Use when work involves Claude, Anthropic, Opus, Sonnet, Haiku, Messages API, tool use, streaming, caching, model migration, or Foundry-hosted Claude clients.

Guide ongoing development of CopilotKit frontends connected over AG-UI to Microsoft Agent Framework agents and Azure AI Foundry hosted agents. Use when adding or gating tools, wiring human-in-the-loop approval, building generative UI, synchronizing shared state, debugging AG-UI event streams, upgrading preview packages, or deploying hosted agent updates.

Use when editing repository GitHub Actions workflows or generated Golden Path workflows.

GitHub CLI operations use gh commands and GitHub API workflows for repositories, issues, pull requests, Actions, packages, repository discovery, GitHub App setup, and pull request automation. Use this skill when working with gh repo, gh pr, gh issue, gh workflow, gh run, gh api, Actions checks, or package operations.

Configures GitHub Codespaces devcontainer environments for Backstage Golden Path templates. Use this skill when creating or validating devcontainer.json, Codespaces setup, Python FastAPI templates, Node app templates, Terraform templates, Java templates, AI/ML pipelines, data pipelines, container features, SDK pre-installation, or template mapping.

Generates path-scoped GitHub Copilot migration instructions from actual branch, commit, tag, or release diffs. Use when handling framework upgrades, architecture refactors, technology migrations, dependency updates, API changes, and obsolete-pattern prevention.

Adopt or review repository-level harness engineering for GitHub Copilot and coding agents. Use when users want durable agent instructions, guardrails, regression checks, drift checks, failure memory, or adoption reports that prevent repeated AI coding-agent mistakes in a target repository.

Generate technology-agnostic blueprints for comprehensive copilot-instructions.md files that make GitHub Copilot follow exact project versions, architecture, code quality, documentation, testing, and versioning conventions discovered from the codebase. Use this skill when the user asks for configuration variables, wants to create copilot-instructions.md, or needs repository-specific GitHub Copilot coding guidance.

Builds applications with the GitHub Copilot SDK using explicit client lifecycle, sessions, permissions, streaming, tools, and MCP integration. Use when embedding Copilot in an application, creating sessions, handling events, registering tools, or troubleshooting SDK behavior.

Retrieve and display GitHub Copilot usage metrics for organizations and enterprises using the GitHub CLI, REST API, and bundled scripts. Use when the user asks about Copilot usage, adoption, active users, acceptance rates, suggestions, chat interactions, per-user breakdowns, organization metrics, enterprise metrics, or usage on a specific date.

Dispatches authorized GitHub issue-comment commands to read-only repository validation. Use when implementing or validating /check-agents, /help, issue comment authorization, command parsing, or IssueOps workflow behavior.

Pipeline diagnostics analyzes GitHub Actions CI/CD failures and remediation patterns. Use this skill when diagnosing workflow failures, build errors, deploy failures, failed jobs or steps, logs triage, actions permissions, OIDC failures, dependency cache issues, and CI/CD debugging.

Use when editing Open Horizons GitHub Issue Forms, chooser configuration, or agent-routing intake fields.

Use when editing tracked AKS, Kubernetes, Helm, Kustomize, or generated GitOps manifests.

Designs, implements, reviews, and evaluates Model Context Protocol servers in TypeScript or Python. Use when creating MCP tools, resources, prompts, transports, authentication, schemas, pagination, or server evaluations for an external API or service.

Use the MCP CLI to discover Model Context Protocol servers, inspect tool schemas, grep tool names, and call MCP tools with JSON, raw text, or stdin arguments. Use when the user asks to list MCP servers, inspect a server/tool schema, call an MCP tool from the command line, or script MCP access with --json or --raw output.

Create, update, refactor, explain, or review Microsoft Agent Framework applications, agents, workflows, and migrations in .NET or Python. Use this skill when working with Microsoft Agent Framework, successor guidance for Semantic Kernel or AutoGen, Azure AI Foundry, Azure OpenAI, OpenAI providers, MCP tools, workflows, middleware, checkpointing, or language-specific samples.

Look up official Microsoft API references, SDK signatures, packages, and working code samples before writing or fixing Azure SDK, .NET, Microsoft Graph, or Microsoft API code. Use when verifying method names, overloads, parameters, authentication patterns, package names, deprecations, RBAC errors, or suspected hallucinated Microsoft SDK calls.

Query official Microsoft documentation and adjacent source documentation for Azure, .NET, Agent Framework, Semantic Kernel, Aspire, VS Code, GitHub, Power Platform, Windows, and M365. Use this skill when the user needs concepts, tutorials, configuration details, API examples, code samples, or current docs for Microsoft ecosystem technologies.

Create hybrid GitHub Copilot skills for Microsoft technologies using Microsoft Learn MCP tools or the mslearn CLI. Use this skill when the user asks to create a skill for Azure, .NET, Microsoft 365, VS Code, Bicep, Semantic Kernel, a Microsoft SDK, an Azure service, a framework, or a Microsoft REST API.

Use when editing tracked Rego, OPA, Gatekeeper templates, or policy constraints.

Assesses read-only Azure readiness for one Open Horizons deployment scope using current subscription, provider, quota, SKU, identity, network, and resource evidence. Use when needed before Terraform planning or deployment when Azure prerequisites may block the requested components.

Operates and integrates the Open Horizons Agentic Engineering Graph (AEG) through Backstage with authenticated run management, G1/G2 decisions, traceability analytics, and golden-path harvesting. Use this skill when starting or inspecting AEG runs, reviewing gates, analyzing AEG evidence, proposing reusable profiles, or wiring the AEG feature into the Open Horizons portal.

Use when editing the Open Horizons Backstage AEG feature, its proxy, actions, agent registry, configuration, or scaffold integration.

Install and use Backstage's AI catalog model for AiResource skills and rules plus mcp-server API entities, ownership, lifecycle, relationships, and source locations. Use when cataloging AI skills, governance rules, agents, or MCP servers.