Claude Skills by paulasilvatech

Create or assess a standalone Backstage adopter application with version-aware prerequisites, package layout, first-run configuration, and baseline validation. Use when starting a Backstage app, reinstalling an app shell, or checking whether a repository is a valid adopter app.

Design, edit, validate, and troubleshoot Backstage app configuration, environment overlays, schemas, secrets, integrations, and frontend visibility. Use when working with app-config YAML, BACKSTAGE_ENV, config:check, deployment overrides, or configuration errors.

Configure, review, and troubleshoot Backstage sign-in, identity resolvers, auth providers, delegated third-party access, callbacks, and permissions. Use when setting up GitHub, Microsoft, guest, proxy, or custom auth providers or fixing login failures.

Run and compare the Backstage catalog query performance battery against a safe database replica, capture PostgreSQL plans and buffers, detect regressions, and update the baseline. Use when changing catalog queries, indexes, schemas, or database performance behavior.

Model, register, discover, validate, and troubleshoot Backstage Software Catalog entities, providers, processors, ownership, relations, locations, and lifecycle. Use when handling catalog-info YAML, entity ingestion, org discovery, duplicate entities, or catalog governance.

Prepare, implement, validate, and document contributions to backstage/backstage or a close fork using targeted tests, exact root typechecking, formatting, linting, API reports, changesets, DCO, and Apache headers. Use when changing Backstage core packages, plugins, docs, or contributor workflows.

Configure, secure, and validate Backstage technical integrations with GitHub, Azure and Azure DevOps, and ServiceNow across catalog discovery, events, software templates, CI/CD views, incidents, and provider credentials. Use when setting up or troubleshooting integrations outside user sign-in.

Choose and implement Backstage framework extension points, core backend services, frontend blueprints, service refs, modules, lifecycle, auth, permissions, schedulers, tracing, metrics, and generated API references. Use when designing plugin architecture or selecting supported framework APIs.

Install, configure, authorize, and troubleshoot Backstage Kubernetes frontend and backend plugins, cluster discovery, entity annotations, authentication, permissions, proxies, custom resources, and service-owner views. Use when working with Kubernetes tabs, clusters, pods, or integration errors.

Register typed Backstage backend actions and expose selected actions as authenticated MCP tools with schemas, attributes, permissions, filters, server instructions, and well-known action validation. Use when configuring the Actions Registry, Actions Service, MCP Actions Backend, or AI tool exposure.

Install, configure, emit, process, route, and troubleshoot Backstage notifications and optional real-time signals. Use when handling user or group notifications, external emitters, email or Slack processors, scaffolder notifications, settings, topics, or delivery failures.

Operate, monitor, troubleshoot, and harden production Backstage services, databases, schedulers, integrations, health endpoints, logs, and deployments. Use when handling startup failures, readiness problems, database errors, provider refresh issues, performance incidents, or production runbooks.

Design, implement, test, and troubleshoot Backstage permission policies, basic and resource permissions, conditional decisions, rules, frontend authorization, and plugin integration. Use when implementing RBAC, ABAC, resource filtering, action visibility, or fixing authorization failures.

Install, configure, extend, operate, and troubleshoot Backstage Search frontends, engines, collators, indices, result extensions, filters, schedules, and permissions. Use when working with search pages, Catalog or TechDocs indexing, custom collators, Postgres or Elasticsearch, or missing results.

Design, implement, validate, and troubleshoot Backstage Software Templates, custom actions, Golden Paths, skeleton rendering, repository publication, and catalog registration. Use when working with template.yaml, scaffolder actions, parameters, step outputs, or template execution failures.

Configure, build, preview, publish, migrate, and troubleshoot Backstage TechDocs and MkDocs content. Use when handling techdocs-ref annotations, mkdocs.yml, local or external builders, object-storage publishers, CI generation, broken docs, or wiki-to-TechDocs migration.

Plan, execute, and validate Backstage application or plugin dependency upgrades with release-aware package alignment, migrations, config review, changesets, and rollback. Use when bumping Backstage versions, resolving package skew, adopting new systems, or preparing an upgrade PR.

Implements focused changes in an existing repository through evidence-driven diagnosis, minimal edits, immediate checks, and proportionate regression validation. Use when handling bug fixes, features, improvements, refactoring, modernization, tests, and documentation updates.

Coordinates end-to-end Open Horizons platform deployment across prerequisites, Terraform, Kubernetes, GitOps, and verification. Use this skill when planning or executing full platform deployment, dry-run deployment, horizon enablement, deployment sequence, post-deploy verification, or deployment troubleshooting.

Executes one approval-gated Open Horizons deployment, rollout, rollback, or verification from an immutable change package. Use when the exact environment, artifact, command, expected actions, approval, validation, and rollback are already known.

Use when validating requirements against EARS notation patterns. Triggers include "EARS", "requirement review", "requirement quality", "shall statement", and "REQ-ID".

Classifies and coordinates repository work across Open Horizons agents with bounded delegation, validation, review, and approval gates. Use when handling cross-domain maintenance, feature, improvement, modernization, incident, review, or explicitly requested greenfield workflows.

Implements and validates one product-specific integration in the existing Open Horizons Backstage portal and agent services. Use when wiring routes, plugins, catalog entities, app configuration, AI Chat SSE behavior, runtime APIs, or Backstage Kubernetes manifests without provisioning Azure or deploying live workloads.

Validates and sets up local CLI tools and access needed before Open Horizons deployment. Use this skill when checking required tool availability, verifying minimum versions, preparing Azure login readiness, validating CI/CD runner prerequisites, or producing a prerequisite checklist.

Performs an independent, read-only security review of one Open Horizons change or surface with severity-ranked, evidence-backed findings and verification criteria. Use when reviewing code, Terraform, Kubernetes, identity, workflows, Backstage, MAF agents, MCP tools, secrets, or policy review.

Investigates one Open Horizons reliability symptom or incident through read-only telemetry, timeline construction, causal hypothesis testing, ownership assignment, and verification planning. Use when investigating outages, latency, errors, unhealthy workloads, alerts, SLO breaches, or deployment regressions.

Implements and validates one bounded Open Horizons Terraform change in terraform/modules or an isolated terraform/environments root. Use when changing a module, environment root, provider constraint, backend declaration, import block, or state-aware Terraform contract without applying infrastructure.

Plans, applies, inspects, or uninstalls Open Horizons repository customizations with conflict detection and managed-file state. Use when publishing the AEG feature, the full toolkit, instructions, VS Code prompts, safety hooks, MCP configuration, workflows, or issue templates to a target repository.

Applies current VS Code prompt conventions for canonical sources, metadata, runtime inputs, tools, destination safety, body structure, and testing. Use when creating or updating a prompt.

Code quality checks, linting, formatting, and type checking commands for the Agent Framework Python codebase. Use when running checks, fixing lint errors, or troubleshooting CI failures.

Coding standards, conventions, and patterns for developing Python code in the Agent Framework repository. Use when writing or modifying Python source files in the python/ directory.

Guidance for package and feature lifecycle in the Agent Framework Python codebase, including stage meanings, feature-stage decorators, feature enums, and how to move APIs from one stage to the next. Use when changing API lifecycle stages or feature annotations.

Guide for managing packages in the Agent Framework Python monorepo, including creating new connector packages, versioning, and the lazy-loading pattern. Use when adding, modifying, or releasing packages.

Guidelines for writing and running tests in the Agent Framework Python codebase. Use when creating, modifying, or running tests.

Use when editing Python agent runtimes, FastAPI boundaries, orchestration, tools, or their tests.

Use when editing tracked SDD artifacts that require naming, EARS, traceability, evidence, or status conventions.

Elicits, normalizes, validates, and traces requirements through a complete Spec-Driven Development workflow using EARS. Use when converting notes, PRDs, legacy evidence, or design inputs into FRD/NFRD, SPECIFICATION.md, architecture and task artifacts, traceability matrices, quality gates, or an implementation-ready SDD handoff.

Use when editing tracked Terraform modules, environments, providers, state contracts, or examples.

Generate complete production-ready application code from an OpenAPI specification, including project structure, models, controllers, services, repositories, validation, error handling, tests, documentation, and environment files. Use this skill when the user asks to generate an application from an OpenAPI spec, scaffold an API server from OpenAPI, or turn an OpenAPI URL, file, or pasted spec into runnable code.

Generate complete production-ready application code from an OpenAPI specification, including project structure, models, controllers, services, repositories, validation, error handling, tests, documentation, and environment files. Use this skill when the user asks to generate an application from an OpenAPI spec, scaffold an API server from OpenAPI, or turn an OpenAPI URL, file, or pasted spec into runnable code.

Generate complete production-ready application code from an OpenAPI specification, including project structure, models, controllers, services, repositories, validation, error handling, tests, documentation, and environment files. Use this skill when the user asks to generate an application from an OpenAPI spec, scaffold an API server from OpenAPI, or turn an OpenAPI URL, file, or pasted spec into runnable code.

Generate complete production-ready application code from an OpenAPI specification, including project structure, models, controllers, services, repositories, validation, error handling, tests, documentation, and environment files. Use this skill when the user asks to generate an application from an OpenAPI spec, scaffold an API server from OpenAPI, or turn an OpenAPI URL, file, or pasted spec into runnable code.

Generate complete production-ready application code from an OpenAPI specification, including project structure, models, controllers, services, repositories, validation, error handling, tests, documentation, and environment files. Use this skill when the user asks to generate an application from an OpenAPI spec, scaffold an API server from OpenAPI, or turn an OpenAPI URL, file, or pasted spec into runnable code.

Discover .NET solution projects, classify Oracle-to-PostgreSQL migration eligibility, detect Oracle dependencies, and write .github/oracle-to-postgres-migration/Reports/MasterMigrationPlan.md. Use when starting a multi-project Oracle-to-PostgreSQL migration, inventorying .NET projects, or assessing Oracle dependency scope.

Create structured bug reports for Oracle-to-PostgreSQL migration defects with source-of-truth Oracle behavior, PostgreSQL divergence, severity, root cause, remediation, validation, and filename convention. Use when documenting behavioral differences, failed migration tests, or data-layer defects during an Oracle-to-PostgreSQL migration.

Create Phase 3 Oracle integration tests for .NET data access artifacts before Oracle-to-PostgreSQL migration, capturing Oracle behavior as the golden baseline while keeping assertions portable for Phase 6. Use when the user asks to add integration tests for repositories, DAOs, stored procedure callers, query builders, seed data, or lookup constants before PostgreSQL migration begins.

Migrate .NET/C# data access code from Oracle.ManagedDataAccess or Oracle.EntityFrameworkCore to PostgreSQL with Npgsql. Use when replacing OracleConnection, OracleCommand, OracleDataReader, OracleDbType mappings, stored procedure calls, connection strings, inline SQL, and EF Core provider configuration during an Oracle-to-PostgreSQL migration.

Migrate Oracle PL/SQL stored procedures and functions to PostgreSQL PL/pgSQL while preserving behavior, signatures, type-anchored inputs, exception handling, rollback logic, collation semantics, and orafce compatibility. Use when converting Oracle Procedures and Functions into PostgreSQL equivalents during an Oracle-to-PostgreSQL migration.

Create an integration testing plan for one .NET project during Oracle-to-PostgreSQL migration. Use when planning coverage for repositories, DAOs, stored procedure callers, CRUD service layers, Oracle-specific behavior, seed data, or migration validation cases before writing integration tests.

Review Oracle-to-PostgreSQL migration plans or completed artifacts for behavioral risks: empty strings, exceptions, refcursors, type coercion, sorting and collations, UNION ALL planner changes, materialized-view refresh, timestamps, sequences, ROWNUM, NVL/DECODE, and concurrent transactions. Use when planning or validating database migrations and integration tests.