Skip to content

Add Aident Skill#366

Open
lukeguo12210 wants to merge 1 commit into
microsoft:mainfrom
lukeguo12210:codex/add-aident-skill
Open

Add Aident Skill#366
lukeguo12210 wants to merge 1 commit into
microsoft:mainfrom
lukeguo12210:codex/add-aident-skill

Conversation

@lukeguo12210

Copy link
Copy Markdown

Summary

  • add aident-skill under .github/skills/ for GitHub Copilot and other skill-aware agents
  • document Aident Loadout CLI, MCP, HTTPS fallback, Vault verification, and troubleshooting workflows
  • add README/docs-site catalog entries and mock harness coverage

Validation

  • python3 .github/skills/skill-creator/scripts/quick_validate.py .github/skills/aident-skill
  • pnpm --dir tests harness aident-skill --mock --verbose
  • pnpm --dir tests typecheck
  • git diff --check

@lukeguo12210 lukeguo12210 requested a review from thegovind as a code owner July 1, 2026 19:11
Copilot AI review requested due to automatic review settings July 1, 2026 19:11

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a new core skill, aident-skill, under .github/skills/. The skill guides skill-aware agents (GitHub Copilot and others) on operating Aident Loadout — discovering capabilities, inspecting live schemas, checking Vault connection state, executing actions, and reviewing audit history — plus reference docs for MCP client setup, an HTTPS/OpenAPI fallback, and troubleshooting. It also registers the skill in the two catalogs (README and the docs-site JSON) and adds mock-harness test coverage (scenarios + acceptance criteria).

Changes:

  • New aident-skill skill: SKILL.md plus four reference docs (loadout.md, mcp.md, api.md, troubleshooting.md).
  • Catalog registration: README count bumped 174→175, README Core table entry, and a new docs-site/src/data/skills.json record (consistent lang: core / category: general with other core skills).
  • Test coverage: scenarios.yaml (schema-valid; mock responses satisfy expected/forbidden patterns) and acceptance-criteria.md.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
.github/skills/aident-skill/SKILL.md Entry point for the skill; routing, operating rules, and version-check flow (version-check references a version frontmatter field that isn't defined).
.github/skills/aident-skill/references/loadout.md Core CLI workflow (discover → schema → Vault → execute → audit) and safety guidance.
.github/skills/aident-skill/references/mcp.md Per-client MCP setup snippets; cross-references a nonexistent "tool list" in SKILL.md.
.github/skills/aident-skill/references/api.md HTTPS/OpenAPI fallback for constrained hosts.
.github/skills/aident-skill/references/troubleshooting.md Auth, missing integrations, schema errors, and reporting guidance.
README.md Skill count bumped to 175 and Core catalog table entry added.
docs-site/src/data/skills.json Docs-site catalog record for the skill; ordering and fields consistent with existing entries.
tests/scenarios/aident-skill/scenarios.yaml Mock-harness scenarios; conforms to the scenarios schema.
tests/scenarios/aident-skill/acceptance-criteria.md Correct/incorrect examples for the operating and MCP flows.

Comment on lines +55 to +59
1. Read the installed `SKILL.md` frontmatter.
2. Fetch `https://aident.ai/.well-known/loadout-skill.json`.
3. Compare the installed `version` with the remote `skillVersion`.
4. If the remote version is newer, refresh with `npx skills add aident-ai/aident-skill` or follow `https://aident.ai/SETUP.md`.
5. Re-read the installed frontmatter and confirm the installed version.
Use Aident to list my available capabilities
```

See [SKILL.md](../SKILL.md) for the full tool list.
@lukeguo12210

Copy link
Copy Markdown
Author

@lukeguo12210 please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.

@microsoft-github-policy-service agree [company="{your company}"]

Options:

  • (default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.
@microsoft-github-policy-service agree
  • (when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.
@microsoft-github-policy-service agree company="Microsoft"

Contributor License Agreement

@microsoft-github-policy-service agree [company="{Aident AI}"]

@microsoft-github-policy-service

Copy link
Copy Markdown
Contributor

@lukeguo12210 the command you issued was incorrect. Please try again.

Examples are:

@microsoft-github-policy-service agree

and

@microsoft-github-policy-service agree company="your company"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants