Skip to content
Back to search

CAIRA

Composable AI Reference Architectures (CAIRA)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/microsoft--caira/badge.svg)](/listings/microsoft--caira)

HTML

<a href="/listings/microsoft--caira"><img src="/api/listings/microsoft--caira/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install the skill from your project directory:

bunx skills add github.com/microsoft/CAIRA/skills

or:

npx skills add github.com/microsoft/CAIRA/skills

Then ask your agent to use CAIRA for your scenario, for example:

Create an agentic monitoring system to detect security-related issues in a configured GitHub repository using Foundry, an API, and a React frontend with a dashboard.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 55 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # CAIRA
  2. CAIRA (Composable AI Reference Architectures) is a small reference library for agents building Azure AI solutions. The primary entrypoint is the CAIRA skill: install the skill, let your coding agent inspect this repository, and have it copy or adapt only the reference pieces that fit your scenario.
  3. Each directory under `reference-architectures/` is an independent reference component that should be easy to read, validate, copy, and modify.
  4. ## Quickstart
  5. Install the skill from your project directory:
  6. ```bash
  7. bunx skills add github.com/microsoft/CAIRA/skills
  8. ```
  9. or:
  10. ```bash
  11. npx skills add github.com/microsoft/CAIRA/skills
  12. ```
  13. Then ask your agent to use CAIRA for your scenario, for example:
  14. ```text
  15. Create an agentic monitoring system to detect security-related issues in a configured GitHub repository using Foundry, an API, and a React frontend with a dashboard.
  16. ```
  17. ## Reference components
  18. | Path | Purpose |
  19. |------|---------|
  20. | `reference-architectures/iac/foundry/` | Terraform for a Foundry account, project, and model deployment. |
  21. | `reference-architectures/iac/container-apps/` | Terraform for Azure Container Apps hosting exactly two apps: API and frontend. |
  22. | `reference-architectures/app/api/typescript/openai-agents-sdk/` | Agentic API reference for Typescript using the OpenAI Agents SDK. |
  23. | `reference-architectures/app/api/typescript/foundry-agent-service/` | Agentic API reference for Typescript using Foundry Agent Service. |
  24. | `reference-architectures/app/api/csharp/microsoft-agent-framework/` | Agentic API reference for C# and Microsoft Agent Framework. |
  25. | `reference-architectures/app/frontend/typescript/react/` | Minimal React frontend with a small BFF proxy to the API. |
  26. ## Contributor workflow
  27. Install dependencies and validate all reference components:
  28. ```bash
  29. task bootstrap
  30. task validate
  31. ```
  32. Validation is intentionally component-local: TypeScript components use npm scripts, C# uses .NET build, Terraform uses `fmt/init/validate`, and each app container has a Dockerfile that can be built independently. You can also run pieces independently with `task security`, `task validate:code`, and `task validate:containers`. Dependency audits and Trivy scans are available separately with `task validate:audit`, `task security:trivy`, and `task validate:containers:trivy`.
  33. The CAIRA skill test can be run locally with `task test:skill`. It installs the skill into a fresh empty workspace, runs the README example prompt through GitHub Copilot CLI in unattended mode, then asks Copilot to verify the generated result.
  34. For the weekly GitHub Actions run, the workflow signs in to Azure with OIDC, gets a short-lived Azure AI Foundry token from the Azure CLI, and configures Copilot CLI BYOK provider environment variables (`COPILOT_PROVIDER_BASE_URL`, `COPILOT_PROVIDER_MODEL_ID`, and optionally `COPILOT_PROVIDER_WIRE_API`) for an OpenAI-compatible Foundry endpoint. The OIDC service principal should have the least-privilege **Cognitive Services OpenAI User** role at the Azure AI Foundry / Azure OpenAI resource that hosts the configured deployment.
  35. ## Developing CAIRA
  36. For information related to developing CAIRA, start with the documentation in [`docs/`](docs/). It includes contributor guidance, local environment setup, troubleshooting notes, and the repository security posture.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.