Skip to content

Instantly share code, notes, and snippets.

name: Renew Let's Encrypt Certificate (Azure DNS)
on:
schedule:
- cron: '0 0 1 * *' # Esegue il primo giorno di ogni mese
workflow_dispatch: # Permette l'avvio manuale per test
jobs:
renew-cert:
runs-on: ubuntu-latest
name description license
devex-principles
Guidelines for DevEx development practices extracted from team reviews and discussions. Use when working on DX modules, GitHub Actions, Terraform configurations, or TypeScript code to ensure consistency with PagoPA DevEx principles. Covers modular design, breaking changes, presets, CI/CD best practices, and collaboration workflows.
Complete terms in LICENSE.txt

DevEx Principles Skill

This skill provides guidelines and best practices extracted from the DevEx team's reviews and discussions in pull requests and issues. Following these principles ensures high-quality, maintainable, and idiomatic code within the PagoPA DX ecosystem.

name description
dx-principles
DevEx Principles: Fundamental guidelines for coding agents based on analysis of DevEx team code reviews and comments. These principles represent the core values and patterns that drive architecture decisions and code quality in the PagoPA DX initiative.

DevEx Fundamental Principles

Overview

This skill document captures the fundamental coding and architecture principles that emerge from the DevEx team's code review patterns and comments. These principles guide the creation of high-quality, maintainable, and secure code within the PagoPA DX initiative.

@gunzip
gunzip / SKILL.md
Last active February 19, 2026 08:02
name description license
azure-functions-v4-migration
Migrate Azure Functions from the deprecated Node.js v3 model to the new v4 model. Use when asked to upgrade Azure Functions, migrate to v4 model, or refactor function handlers to follow the latest standards.
Complete terms in LICENSE.txt

Azure Functions v4 Migration Skill

This skill provides the instructions and patterns required to migrate PagoPA Azure Functions from the deprecated Node.js v3 model to the new v4 model using the wrapHandlerV4 adapter from @pagopa/io-functions-commons.

name description
node-24-migration
Assist users in migrating their Node.js projects to version 24.x LTS. Use when users ask to migrate Node.js versions and current version is 20.x or 22.x.

Node.js 20.x to 24.x Migration Assistant

This skill helps you migrate Node.js projects from version 20.x to 24.x LTS by identifying breaking changes, running codemods, and ensuring compatibility.

Migration Overview

Plan: Migrate from Yarn/NPM to pnpm

Migrate the monorepo from YARN or npm to pnpm. This migration enforces strict dependency management by fixing ghost dependencies individually, updating Dockerfiles, and migrating GitHub Actions.

IMPORTANT: Mandatory Constraints

  • Do not commit any changes to git without explicit instruction.
  • Prefer pnpm add / pnpm add -D when adding dependencies to preserve lockfile integrity.
  • Keep npm install -g when installing global packages in Dockerfile and/or GitHub Workflows. Never replace it with pnpm add -g.
  • Ensure all commands using yarn are replaced with their pnpm equivalents. ie. yarn workspace -> pnpm --filter, yarn build -> pnpm build, etc.
name description
dx-search
Searches the DX knowledge base. Activate when users type @dx in their prompt or mention PagoPA DX practices, pipelines or Terraform Modules.

DX Search Skill

This skill allows searching the PagoPA DX (Developer Experience) knowledge base

name description
pagopa-dx
Comprehensive guide to PagoPA Developer Experience (DX) tools, patterns, best practices and infrastructure Terraform modules. Use when users type "@dx" in their prompt or ask for PagoPA DX documentation.

PagoPA DX Knowledge Base

Plan: Migrate from Yarn/NPM to pnpm

Migrate the monorepo from Yarn or NPM to pnpm. This migration enforces strict dependency management by fixing ghost dependencies individually, updating Dockerfiles, and migrating GitHub Actions.

Constraints

  • Do not commit any changes to git without explicit instruction.
  • Prefer pnpm add / pnpm add -D when adding dependencies to preserve lockfile integrity.
  • never use pnpm@latest, always try to use the same version as specified in the root package.json file using corepack without version.
title description
Corporate TechRadar Check for GitHub Copilot
A skill for GitHub Copilot to check technology recommendations against the corporate TechRadar.

This skill allows GitHub Copilot to automatically check the ring (e.g., "adopt", "hold") of potentially useful technologies during code generation, by consulting the corporate techradar hosted at