Install guide

Install Guide

Setup commands for installing approved skills into Copilot, Codex, or Cursor.

Installing Agent Skills

Each skill README owns the concrete setup command for that skill. For the Azure DevOps PBI skill, use the setup script instead of the generic install helper because it also checks Azure CLI, configures Azure DevOps, and verifies read-only board access.

Give This To Your Agent

Point your agent at this repository and paste this prompt:

Use the Agent Skills repository at https://dev.azure.com/difzses/iDPCC/_git/iDPCC-Agent-Skills. Read README.md, AGENTS.md, docs/installing-agent-skills.md, and docs/new-user-setup.md. Install the Azure DevOps PBI skill for the agent I am using. If you are Codex, use scripts/setup-azure-devops-pbi-skill.sh codex. If I ask for GitHub Copilot or Cursor, use the matching command in docs/installing-agent-skills.md. Use normal az login with my work account. Do not ask for a shared PAT. If Azure DevOps CLI extension install fails with SSLCertVerificationError, follow the certificate guidance in docs/new-user-setup.md.

Copy The Setup Command

From the repo root, use the copy button on the command block for your agent.

GitHub Copilot:

scripts/setup-azure-devops-pbi-skill.sh copilot /path/to/project-repo

Codex:

scripts/setup-azure-devops-pbi-skill.sh codex

Cursor:

scripts/setup-azure-devops-pbi-skill.sh cursor /path/to/project-repo

The setup script installs the skill for the selected agent, installs or checks the Azure DevOps CLI extension, runs normal az login when needed, configures the expected org/project defaults, and verifies read-only board access.

If the Azure DevOps CLI extension install fails with SSLCertVerificationError, follow New User Setup. That error usually means Azure CLI/Python does not trust the corporate TLS inspection certificate; a PAT or Azure Boards permission change will not fix the extension download.

Analytics Metadata

The Azure DevOps PBI skill is prepared for dashboard analytics without requiring dashboard API calls from each teammate's machine. Agents write safe agent-analytics:v1 metadata into Azure Boards discussion comments on PBIs and tasks they touch. A central collector can read those comments later and populate the hosted dashboard database.

This default path only requires normal Azure Boards access. Do not store dashboard API keys, install credentials, or collector credentials in this repository.

Install Helper

The setup script above is the recommended Azure DevOps PBI path. The generic helper below is what that setup script uses internally and what future skills can use when they do not need their own setup script. From the repo root, use the Copilot target for normal team installs:

scripts/install-skill.sh azure-devops-pbi copilot /path/to/project

Codex and Cursor are supported alternate targets when you are using those tools:

scripts/install-skill.sh azure-devops-pbi codex

scripts/install-skill.sh azure-devops-pbi cursor /path/to/project

Add --force to replace an existing install.

What It Does

Target	What Gets Added
GitHub Copilot	Copies the skill to `.agent-skills/<skill-name>/` and creates `.github/instructions/<skill-name>.instructions.md`.
Codex	Copies `skills/<skill-name>/` to `${CODEX_HOME:-~/.codex}/skills/<skill-name>/`.
Cursor	Copies the skill to `.agent-skills/<skill-name>/` and creates `.cursor/rules/<skill-name>.mdc`.

For skills that access Azure DevOps, prefer the skill-specific setup command in that skill README.