Official agent skill

Sdaf Orientation And Surface

by Azure in Azure/sap-automation

Orient a newcomer to the SAP Deployment Automation Framework (SDAF): explain the spine (control plane → workload zone → SAP system → software → install → operate/remove), summarise the three…

OfficialMITAuto-check passedDevOps & Cloud

Install Sdaf Orientation And Surface

skills CLI
$ npx skills add Azure/sap-automation --skill sdaf-orientation-and-surface -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Azure/sap-automation sdaf-orientation-and-surface --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Azure/sap-automation.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sdaf-orientation-and-surface .claude/skills/sdaf-orientation-and-surface && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sdaf-orientation-and-surface
GitHub stars
146
Token cost
~1.6k tokens
SKILL.md length
553 words
Files
2 (incl. references)
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Orient a newcomer to the SAP Deployment Automation Framework (SDAF): explain the spine (control plane → workload zone → SAP system → software → install → operate/remove), summarise the three…

  • Works in 6 steps: Control plane — deployer + SAP library,… → Workload zone — landscape / networking /… → SAP system — VMs + inventory; reads… → …
  • A user says what is SDAF
  • SKILL.md covers When to invoke, The spine (order is enforced), The three execution surfaces and What this skill does and does…, plus 3 more sections
  • Reaches github.com

What it does

Sdaf Orientation And Surface is an agent skill from Azure/sap-automation, published by the product's own GitHub organization. Orient a newcomer to the SAP Deployment Automation Framework (SDAF): explain the spine (control plane → workload zone → SAP system → software → install → operate/remove), summarise the three execution surfaces (Local, Azure DevOps, GitHub Actions), and print the install command for the matching surface bootstrap plugin — as documented in this repository's docs/PLUGINS.md — so the operator can run it manually. Use when a user says "what is SDAF", "how is SDAF structured", "where do I start with SDAF", "which…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/surface-decision.md`).

It sits in DevOps & Cloud, covering CI/CD and Deployment. It works with Azure DevOps, GitHub Actions, GitHub and Microsoft Azure. The repository describes itself as: This is the repository supporting the SAP deployment automation framework on Azure. The licence is MIT.

When your agent uses it

  • A user says what is SDAF
  • How is SDAF structured
  • Where do I start with SDAF
  • Which surface should I use

Example prompts

  • “what is SDAF”
  • “how is SDAF structured”
  • “where do I start with SDAF”
  • “/sdaf-orientation-and-surface”

Requirements

  • Pre-approved tools (allowed-tools): shell

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Control plane — deployer + SAP library, establishes remote Terraform
  2. Workload zone — landscape / networking / zone Key Vault; reads
  3. SAP system — VMs + inventory; reads deployer + landscape state
  4. Software download — needs the workload-zone Key Vault credentials
  5. Install — OS + DB + SAP via Ansible playbooks
  6. Operate / recover / remove — reverse dependency order for removal

What it can do on your machine

Read from SKILL.md and the folder at commit 78835f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • shell

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sdaf Orientation And Surface loads about 1.6k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 225 tokens; SKILL.md has 553 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~225
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Azure/sap-automation at commit 78835f0, republished under its MIT licence (© Azure). 553 words, ~1,626 tokens.

Download SKILL.mdSave it as .claude/skills/sdaf-orientation-and-surface/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
sdaf-orientation-and-surface
description
Orient a newcomer to the SAP Deployment Automation Framework (SDAF): explain the spine (control plane → workload zone → SAP system → software → install → operate/remove), summarise the three execution surfaces (Local, Azure DevOps, GitHub Actions), and print the install command for the matching surface bootstrap plugin — as documented in this repository's `docs/PLUGINS.md` — so the operator can run it manually. Use when a user says "what is SDAF", "how is SDAF structured", "where do I start with SDAF", "which surface should I use", "SDAF Local vs ADO vs GitHub", "workstation vs Azure Pipelines vs GitHub workflows", "how do I install the SDAF ADO/GitHub plugin", or "I'm new to SDAF". Do NOT use for readiness pre-flight (see sdaf-readiness-check), workspace/tfvars layout (see sdaf-workspace-and-tfvars), or troubleshooting a failed run (see sdaf-failure-triage).
allowed-tools
shell
license
MIT

SDAF Orientation and Surface Choice

Primer skill. Answers "what is SDAF and which execution surface should I use?" and hands off to the next action-loop skill. Grounded in the shipped docs; no inferred procedures.

When to invoke

Trigger on: "what is SDAF", "where do I start", "SDAF surface", "Local vs ADO vs GitHub", "SDAF plugin install command", "how do I install azure-sap-automation-devops", "which surface for SDAF".

Do NOT trigger on: pre-flight readiness checks, tfvars/WORKSPACES authoring, BOM selection, failed-run triage. Route to the sibling skill instead.

The spine (order is enforced)

Docs enforce this order for every surface:

  1. Control plane — deployer + SAP library, establishes remote Terraform state (docs/local/03-00-control-plane.md § Outcome, § What the automation does).
  2. Workload zone — landscape / networking / zone Key Vault; reads control-plane state (docs/local/04-00-workload-zone.md § Outcome).
  3. SAP system — VMs + inventory; reads deployer + landscape state (docs/local/05-00-sap-system.md § Outcome).
  4. Software download — needs the workload-zone Key Vault credentials (docs/local/06-00-software-and-installation.md § Download software).
  5. Install — OS + DB + SAP via Ansible playbooks (docs/local/06-00-software-and-installation.md § Run configuration and installation).
  6. Operate / recover / remove — reverse dependency order for removal (docs/local/07-00-operations.md § Remove resources).

Never let a stage run before the prior one completed (docs/local/README.md § Complete the journey).

The three execution surfaces

Docs explicitly frame the surfaces as "capability differences, not a ranking": there is no declared primary (docs/deployment-options.md § Select an execution model). They are not one-to-one equivalent.

SurfaceWhen it fitsDoc anchor
Local / scriptedYou run deploy/scripts/* directly from a workstation, deployer, or automation host. No hosted stage generator.docs/deployment-options.md § Local or scripted execution; docs/local/README.md § Run SDAF locally
Azure DevOpsAzure Repos/Pipelines, service connections, agent pools own the process. Wrapper pipelines exist but docs note ADO "does not currently provide verified one-to-one equivalents for all GitHub generation workflows".docs/deployment-options.md § Azure DevOps
GitHub ActionsGitHub owns the config repo and approvals. Includes stage-generation workflows and deploy workflows.docs/deployment-options.md § GitHub Actions

See references/surface-decision.md for the two-question decision walkthrough and the hand-off to the next skill.

Show full SKILL.md (238 more words)Show less

What this skill does and does NOT do

Does: classify the request, explain the spine, help pick a surface, and print the install command for the matching bootstrap plugin — the operator runs it themselves.

Does NOT: install anything. Does not run a plan/apply. Does not fabricate "which surface is best" — the docs decline to rank them and this skill honours that.

Print the surface bootstrap install command

The canonical install commands for the hub and both surface plugins are documented in docs/PLUGINS.md (this repo). Print the block that matches the operator's chosen surface verbatim from that file, and instruct the operator to run it themselves. Do not invent alternatives, do not paraphrase, do not shorten.

The exact command shapes at the time this skill was authored (source: docs/PLUGINS.md):

Azure DevOps — from docs/PLUGINS.md § Install: Azure DevOps surface plugin (azure-sap-automation-devops):

text
# GitHub Copilot CLI
copilot plugin marketplace add Azure/sap-automation-bootstrap
copilot plugin install azure-sap-automation-devops@sap-automation-bootstrap

# Claude Code
/plugin marketplace add Azure/sap-automation-bootstrap
/plugin install azure-sap-automation-devops@sap-automation-bootstrap

# Gemini CLI
gemini extensions install https://github.com/Azure/sap-automation-bootstrap

GitHub Actions — from docs/PLUGINS.md § Install: GitHub Actions surface plugin (azure-sap-automation-github):

text
# GitHub Copilot CLI
copilot plugin marketplace add Azure/sap-automation-gh-bootstrap
copilot plugin install azure-sap-automation-github@sap-automation-gh-bootstrap

# Claude Code
/plugin marketplace add Azure/sap-automation-gh-bootstrap
/plugin install azure-sap-automation-github@sap-automation-gh-bootstrap

# Gemini CLI
gemini extensions install https://github.com/Azure/sap-automation-gh-bootstrap

Local — no surface plugin is required. Hand off directly to sdaf-readiness-check.

The Copilot install form is <plugin-name>@<marketplace-name> where the marketplace name matches the repository slug (e.g. sap-automation-bootstrap), not the plugin name. If docs/PLUGINS.md and this skill body ever diverge, docs/PLUGINS.md is the source of truth — update this skill in lockstep.

Hand-off

After the surface is chosen and the surface plugin (if any) is installed by the operator, hand off to sdaf-readiness-check for pre-flight, then sdaf-workspace-and-tfvars before any deploy skill.

See also

  • docs/PLUGINS.md — canonical install commands.
  • sdaf-readiness-check, sdaf-workspace-and-tfvars, sdaf-control-plane-bootstrap.
  • docs/local/README.md, docs/deployment-options.md.

© Azure, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/sdaf-orientation-and-surface of Azure/sap-automation.

  • SKILL.md
  • references/surface-decision.md

Open the folder on GitHubat commit 78835f0

Compare with similar skills

Sdaf Orientation And Surface next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sdaf Orientation And Surface compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sdaf Orientation And Surface this skillAzure/sap-automation146—~1.6kAutomated safety check: PassMIT
Setup Pipelinemicrosoft/power-platform-skills984—~11kAutomated safety check: NotesMIT
Adf MasterKilo-Org/kilo-marketplace190—~3.2kAutomated safety check: PassMIT
AI News RadarLearnPrompt/ai-news-radar1.8k—~2.5kAutomated safety check: NotesMIT
ONNX Runtime CI Managementmicrosoft/onnxruntime22k—~4.1kAutomated safety check: PassMIT
Use Vercel Actionamondnet/vercel-action764—~2.7kAutomated safety check: PassMIT

Similar skills

  • Setup Pipeline

    microsoft/power-platform-skills

    Official

    Sets up a Power Platform Pipeline for automated Power Pages deployments.

    984 GitHub stars~11k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Adf Master

    Kilo-Org/kilo-marketplace

    Azure Data Factory (ADF) CI/CD, deployment, and pipeline development.

    190 GitHub stars~3.2k tokensUpdated 11 days ago
    DevOps & CloudAuto-check passed
  • AI News Radar

    LearnPrompt/ai-news-radar

    A skill your agent uses when working on AI News Radar, 24 小时 AI 更新雷达, AI 更新雷达, 伯乐Skill, or Scout Skill: finding high-signal AI/tech sources, adding RSS/OPML/GitHub feeds, checking source health…

    1.8k GitHub stars~2.5k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • ONNX Runtime CI Management

    microsoft/onnxruntime

    Official

    Triggers, re-runs and unblocks the CI checks on an ONNX Runtime pull request, after diagnosing whether a failure is transient or needs a code change.

    22k GitHub stars~4.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Use Vercel Action

    amondnet/vercel-action

    Wire amondnet/vercel-action into a GitHub Actions workflow to deploy Vercel projects from CI.

    764 GitHub stars~2.7k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Prepare Cloudflare Production Deployment

    LubomirGeorgiev/cloudflare-workers-nextjs-saas-template

    Source-of-truth runbook for preparing this Vinext Cloudflare Workers SaaS template for production deployment.

    786 GitHub stars~5.9k tokensUpdated today
    DevOps & CloudAuto-check: notes

More from Azure/sap-automation

All 19 skills in this repo
  • Sdaf Bom Selection

    Azure/sap-automation

    Official

    Pick the right SDAF BOM for a target SAP product / release / DB platform / version / kernel / topology.

    146 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Sdaf Quality Assurance

    Azure/sap-automation

    Official

    Validate a deployed SDAF SAP system through the SDAF-owned QA entry points: the local quality-assurance menu and the documented Azure DevOps pipeline 13 path.

    146 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Sdaf Sap Installation

    Azure/sap-automation

    Official

    Guide SDAF operating-system, database, and SAP installation after the SAP-system workspace and reviewed media are ready.

    146 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Sdaf Sovereign Cloud

    Azure/sap-automation

    Official

    Explain the current SDAF sovereign-cloud deltas without inventing a generic "all sovereigns" runbook.

    146 GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed
  • Sdaf State Management

    Azure/sap-automation

    Official

    Inspect and repair SDAF Terraform state safely before any reviewed import/remove.

    146 GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Sdaf Workspace And Tfvars

    Azure/sap-automation

    Official

    Explain and validate the SDAF WORKSPACES layout (DEPLOYER / LIBRARY / LANDSCAPE / SYSTEM), the region-code naming convention, and how the four tfvars files hang off it.

    146 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Sdaf Orientation And Surface

What does Sdaf Orientation And Surface do?

Orient a newcomer to the SAP Deployment Automation Framework (SDAF): explain the spine (control plane → workload zone → SAP system → software → install → operate/remove), summarise the three…. Sdaf Orientation And Surface is an agent skill from Azure/sap-automation, published by the product's own GitHub organization.md — so the operator can run it manually.

When should I use Sdaf Orientation And Surface?

Sdaf Orientation And Surface fits situations like: A user says what is SDAF; how is SDAF structured; where do I start with SDAF; which surface should I use.

How do I install Sdaf Orientation And Surface in Claude Code?

Run `npx skills add Azure/sap-automation --skill sdaf-orientation-and-surface -a claude-code`. Or copy the skill folder (skills/sdaf-orientation-and-surface in Azure/sap-automation) into .claude/skills/sdaf-orientation-and-surface in your project. Claude Code loads it when a task matches its description.

How do I install Sdaf Orientation And Surface in Codex?

Run `npx skills add Azure/sap-automation --skill sdaf-orientation-and-surface -a codex`. Or copy the skill folder (skills/sdaf-orientation-and-surface in Azure/sap-automation) into .agents/skills/sdaf-orientation-and-surface in your project. Codex loads it when a task matches its description.

Can I use Sdaf Orientation And Surface in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Azure/sap-automation --skill sdaf-orientation-and-surface -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sdaf-orientation-and-surface, .gemini/skills/sdaf-orientation-and-surface, .github/skills/sdaf-orientation-and-surface and .opencode/skills/sdaf-orientation-and-surface in your project.

What does Sdaf Orientation And Surface need to run?

SKILL.md names no scripts, command-line tools or credentials: Sdaf Orientation And Surface is instructions for the agent only. Its frontmatter pre-approves these tools: shell.

Does Sdaf Orientation And Surface access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Sdaf Orientation And Surface safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sdaf Orientation And Surface use?

Sdaf Orientation And Surface is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sdaf Orientation And Surface use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 411 tokens, read only when the agent opens those files.

What are the alternatives to Sdaf Orientation And Surface?

Skills that share tags, products or a category with Sdaf Orientation And Surface: Setup Pipeline (microsoft/power-platform-skills, 984 stars), Adf Master (Kilo-Org/kilo-marketplace, 190 stars), AI News Radar (LearnPrompt/ai-news-radar, 1.8k stars) and ONNX Runtime CI Management (microsoft/onnxruntime, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sdaf Orientation And Surface?

Azure (a GitHub organization, an official publisher) maintains it in Azure/sap-automation, which has 146 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 8, 2026.

Source: Azure/sap-automation on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.