Official agent skill

Connection Properties

by microsoft in microsoft/aspire

Specialized agent for creating and improving Connection Properties in Aspire resource and README files

OfficialMITAuto-check passedDevelopment

Install Connection Properties

skills CLI
$ npx skills add microsoft/aspire --skill connection-properties -a claude-code

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

GitHub CLI
$ gh skill install microsoft/aspire connection-properties --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/microsoft/aspire.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/connection-properties .claude/skills/connection-properties && 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
connection-properties
GitHub stars
6.3k
Token cost
~1k tokens
SKILL.md length
249 words
Files
1
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Specialized agent for creating and improving Connection Properties in Aspire resource and README files

  • Tasks that involve Technical documentation
  • SKILL.md covers IResourceWithConnectionString.G…, Parent resources and Documentation
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Connection Properties is an agent skill from microsoft/aspire, published by the product's own GitHub organization. Specialized agent for creating and improving Connection Properties in Aspire resource and README files

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Technical documentation. It works with Microsoft Azure and Microsoft SQL Server. The repository describes itself as: Aspire is the tool for code-first, extensible, observable dev and deploy. The licence is MIT.

When your agent uses it

  • Tasks that involve Technical documentation

Example prompts

  • “/connection-properties”

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are c# and markdown).

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

  • Network

    No URLs in SKILL.md.

    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

Connection Properties loads about 1k tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 249 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~31
When it runs · the whole SKILL.md, loaded when a task matches
~1k

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 microsoft/aspire at commit a3f44d2, republished under its MIT licence (© microsoft). 249 words, ~1,037 tokens.

Download SKILL.mdSave it as .claude/skills/connection-properties/SKILL.md (or your agent's skills folder).
name
connection-properties
description
Specialized agent for creating and improving Connection Properties in Aspire resource and README files

You are a C# developer. Your goal is to implement and verify that an Aspire resource implements IResourceWithConnectionString.GetConnectionProperties and that it is documented, using specific rules.

IResourceWithConnectionString.GetConnectionProperties rules

Common Connection properties are

  • Host
  • Port
  • Password, when available
  • UserName, when available
  • Uri, representing a service resource url, like [protocol]://[username]:[password]@[host]:[port]/[subresource]?parameter=...
  • Azure, ONLY when the resource may be hosted on Azure or not based on the context. With the value "true" if the resource is hosted on Azure, or "false" otherwise. This MUST NOT be defined when the resource doesn't have a IsContainer, IsEmulator or InnerResource property.
  • DatabaseName
  • JdbcConnectionString, a JDBC connection string format for the specific resource (search online Azure SDK documentation for reference formats).

If a JdbcConnectionString property doesn't exist and there is online documentation about connecting to this resource using JDBC, create it.

Parent resources

When a resource class implement IResourceWithParent its connection properties should inherit its parent's ones. Then define it own to override the values, like Uri if applicable.

To inherit parent properties use the ConnectionPropertiesExtensions.CombineProperties method like this:

c#
IEnumerable<KeyValuePair<string, ReferenceExpression>> IResourceWithConnectionString.GetConnectionProperties() =>
    Parent.CombineProperties([
        new("Database", ReferenceExpression.Create($"{DatabaseName}")),
        new("Uri", UriExpression),
        new("JdbcConnectionString", JdbcConnectionString),
    ]);

Where Parent comes from the IResourceWithParent interface.

Documentation

Each Azure resource has an associated README.md file in the same folder. Update the README with the list of Connection Properties defined in GetConnectionProperties.

Here is a sample section for Sql Server:

md
## Connection Properties

When you reference a SQL Server resource using `WithReference`, the following connection properties are made available to the consuming project:

### SQL Server server

The SQL Server server resource exposes the following connection properties:

| Property Name | Description |
|---------------|-------------|
| `Host` | The hostname or IP address of the SQL Server |
| `Port` | The port number the SQL Server is listening on |
| `Username` | The username for authentication |
| `Password` | The password for authentication |
| `Uri` | The connection URI in mssql:// format, with the format `mssql://{Username}:{Password}@{Host}:{Port}` |
| `JdbcConnectionString` | JDBC-format connection string, with the format `jdbc:sqlserver://{Host}:{Port};trustServerCertificate=true`. User and password credentials are provided as separate `Username` and `Password` properties. |

### SQL Server database

The SQL Server database resource inherits all properties from its parent `SqlServerServerResource` and adds:

| Property Name | Description |
|---------------|-------------|
| `Uri` | The connection URI in mssql:// format, with the format `mssql://{Username}:{Password}@{Host}:{Port}/{DatabaseName}` |
| `JdbcConnectionString` | JDBC connection string with database name, with the format `jdbc:sqlserver://{Host}:{Port};trustServerCertificate=true;databaseName={DatabaseName}`. User and password credentials are provided as separate `Username` and `Password` properties. |
| `Database` | The name of the database |

Aspire exposes each property as an environment variable named `[RESOURCE]_[PROPERTY]`. For instance, the `Uri` property of a resource called `db1` becomes `DB1_URI`.
  • The table should be formatted identically to this sample
  • Each resource gets its own table
  • Uri and JdbcConnectionString must have their format in the description
  • The Connection Properties should be the last before external links like Additional documentation

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

Files

Just SKILL.md in .agents/skills/connection-properties of microsoft/aspire.

Open the folder on GitHubat commit a3f44d2

Compare with similar skills

Connection Properties 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.

Connection Properties compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Connection Properties this skillmicrosoft/aspire6.3k—~1kAutomated safety check: PassMIT
Aliyun Platform Docs Benchmarkcinience/alicloud-skills397—~969Automated safety check: PassMIT
Azure DocumentdbMicrosoftDocs/Agent-Skills777—~4.2kAutomated safety check: PassCC-BY-4.0
Azure MigrateMicrosoftDocs/Agent-Skills777—~5.2kAutomated safety check: PassCC-BY-4.0
FoundatioFoundatioFx/Foundatio2.1k—~3.9kAutomated safety check: PassApache-2.0
Azure PricesCode-and-Sorts/awesome-copilot-agents579—~905Automated safety check: PassCC0-1.0

Similar skills

  • Aliyun Platform Docs Benchmark

    cinience/alicloud-skills

    A skill your agent uses when benchmarking similar product documentation and API documentation across Alibaba Cloud, AWS, Azure, GCP, Tencent Cloud, Volcano Engine, and Huawei Cloud.

    397 GitHub stars~969 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Azure Documentdb

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure DocumentDB development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations &…

    777 GitHub stars~4.2k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Azure Migrate

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure Migrate development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations &…

    777 GitHub stars~5.2k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Foundatio

    FoundatioFx/Foundatio

    A skill your agent uses when working with Foundatio infrastructure abstractions for .NET -- caching, queuing, messaging, file storage, distributed locking, or background jobs.

    2.1k GitHub stars~3.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Azure Prices

    Code-and-Sorts/awesome-copilot-agents

    Look up and compare Azure service pricing using the Azure Retail Prices API.

    579 GitHub stars~905 tokensUpdated 5 mo ago
    DatabasesAuto-check passed
  • Cosmosdb Best Practices

    microsoft/vscode-cosmosdb

    Official

    Azure Cosmos DB performance optimization and best practices guidelines for NoSQL, partitioning, queries, and SDK usage.

    200 GitHub stars~4.3k tokensUpdated today
    DatabasesAuto-check passed

More from microsoft/aspire

All 22 skills in this repo
  • Azdo Internal

    microsoft/aspire

    Official

    A skill your agent uses when asked to trigger or inspect Aspire internal Azure DevOps builds, source-index runs, or release validation on dnceng/internal; push to the internal mirror; download build…

    6.3k GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • Backport PR

    microsoft/aspire

    Official

    Backports a merged PR to a release branch by triggering the /backport bot, waiting for the bot-created PR, and filling in the shiproom template (Customer Impact, Testing, Risk, Regression?).

    6.3k GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Bump Aspire Version

    microsoft/aspire

    Official

    Bumps the Aspire repository product version in eng/Versions.props using previous version-bump commits as guidance.

    6.3k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • CI Test Failures

    microsoft/aspire

    Official

    Guide for diagnosing GitHub Actions test failures, extracting failed tests from runs, and creating or updating failing-test issues.

    6.3k GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • Create PR

    microsoft/aspire

    Official

    Create a pull request using the repository PR template. An agent skill from microsoft/aspire.

    6.3k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Dashboard Testing

    microsoft/aspire

    Official

    Guide for writing tests for the Aspire Dashboard. An agent skill from microsoft/aspire.

    6.3k GitHub stars~4.7k tokensUpdated today
    Auto-check passed

Categories

Questions about Connection Properties

What does Connection Properties do?

Specialized agent for creating and improving Connection Properties in Aspire resource and README files. Connection Properties is an agent skill from microsoft/aspire, published by the product's own GitHub organization.

When should I use Connection Properties?

Connection Properties fits situations like: tasks that involve Technical documentation.

How do I install Connection Properties in Claude Code?

Run `npx skills add microsoft/aspire --skill connection-properties -a claude-code`. Or copy the skill folder (.agents/skills/connection-properties in microsoft/aspire) into .claude/skills/connection-properties in your project. Claude Code loads it when a task matches its description.

How do I install Connection Properties in Codex?

Run `npx skills add microsoft/aspire --skill connection-properties -a codex`. Or copy the skill folder (.agents/skills/connection-properties in microsoft/aspire) into .agents/skills/connection-properties in your project. Codex loads it when a task matches its description.

Can I use Connection Properties 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 microsoft/aspire --skill connection-properties -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/connection-properties, .gemini/skills/connection-properties, .github/skills/connection-properties and .opencode/skills/connection-properties in your project.

What does Connection Properties need to run?

SKILL.md names no scripts, command-line tools or credentials: Connection Properties is instructions for the agent only.

Does Connection Properties access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Connection Properties 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 Connection Properties use?

Connection Properties is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Connection Properties use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Connection Properties?

Skills that share tags, products or a category with Connection Properties: Aliyun Platform Docs Benchmark (cinience/alicloud-skills, 397 stars), Azure Documentdb (MicrosoftDocs/Agent-Skills, 777 stars), Azure Migrate (MicrosoftDocs/Agent-Skills, 777 stars) and Foundatio (FoundatioFx/Foundatio, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Connection Properties?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/aspire, which has 6,348 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 8, 2026.

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