Viktor Hofer
7747fcb427
* Move skill-validator docs under src/ and include in packages Move README.md to src/ and InvestigatingResults.md + OverfittingDetection.md to src/docs/ so they ship in the NuGet package and .tar.gz archives. - Include docs/*.md in NuGet pack and publish output via CopyToPublishDirectory - Add LICENSE to publish output (tar.gz only, not NuGet — uses PackageLicenseExpression) - Replace enumerated docOnlyFiles lists with a regex pattern in CI workflows - Deduplicate eval.yaml docs between CONTRIBUTING.md and the shipping README - Add test fixture files walkthrough to README (moved from CONTRIBUTING.md) - Add AGENTS.md guidance: src/ is the packaging boundary Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update link format in failure diagnosis message * Update AGENTS.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Viktor Hofer <vihofer@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1.4 KiB
Repository Instructions
This repository contains skill plugins under plugins/. Each subdirectory in plugins/ is an independent plugin (e.g., plugins/dotnet-msbuild, plugins/dotnet).
Build
When you modify skills, run the agentic-workflows build script to validate and regenerate compiled artifacts.
pwsh agentic-workflows/<plugin>/build.ps1
This validates skill frontmatter and recompiles knowledge lock files. Always commit the regenerated lock files together with your changes.
Skill-Validator
Don't care much about backwards-compatibility for this tool. Consumers understand that the shape is constantly changing.
The skill-validator is a shipping tool — its NuGet package and .tar.gz archives are built from eng/skill-validator/src/. Content referenced at runtime or bundled with the tool (docs, README, etc.) must live under src/ so it is included in the published output. Do not add references from src/ to files outside of it, except for explicitly linked packaging assets (such as the repo-root LICENSE file) referenced by the project file.
When modifying the evaluation pipeline (evaluation.yml), results JSON schema (Models.cs), or the skill-validator evaluation logic, review and update eng/skill-validator/src/docs/InvestigatingResults.md to keep the failure investigation guidance, schema documentation, and example scripts in sync.