Add Aident Skill#366
Conversation
There was a problem hiding this comment.
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-skillskill:SKILL.mdplus 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.jsonrecord (consistentlang: core/category: generalwith other core skills). - Test coverage:
scenarios.yaml(schema-valid; mock responses satisfy expected/forbidden patterns) andacceptance-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. |
| 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. |
@microsoft-github-policy-service agree [company="{Aident AI}"] |
|
@lukeguo12210 the command you issued was incorrect. Please try again. Examples are: and |
Summary
aident-skillunder.github/skills/for GitHub Copilot and other skill-aware agentsValidation
python3 .github/skills/skill-creator/scripts/quick_validate.py .github/skills/aident-skillpnpm --dir tests harness aident-skill --mock --verbosepnpm --dir tests typecheckgit diff --check