Skip to content

refactor(skills): reinstall from upstreams, drop skills-lock.json#1402

Merged
botantler[bot] merged 2 commits intomainfrom
devantler/lean-into-gh-skill-frontmatter
Apr 19, 2026
Merged

refactor(skills): reinstall from upstreams, drop skills-lock.json#1402
botantler[bot] merged 2 commits intomainfrom
devantler/lean-into-gh-skill-frontmatter

Conversation

@devantler
Copy link
Copy Markdown
Contributor

@devantler devantler commented Apr 19, 2026

Re-install each agent skill from its original upstream repo via gh skill install, so every installed SKILL.md now carries metadata.github-* frontmatter pointing at the true origin instead of devantler-tech/skills. gh skill update --all reads that metadata directly, making the sidecar skills-lock.json redundant.

Type of change

  • 🧹 Refactor

What changed

  • Delete skills-lock.json.
  • Reinstall 11 of 12 skills from upstream via gh skill install <owner/repo> <path> --agent github-copilot --scope project --dir .agents/skills.
  • Bump .github/workflows/update-skills.yaml to the refreshed reusable workflow and swap the skills-lock input for the new dir input.

⚠️ siderolabs skill dropped temporarily

siderolabs/docs ships its skill as public/skill.md (lowercase), which gh skill install rejects — it only recognises SKILL.md. Until the upstream renames the file (or gh skill gains a case-insensitive fallback), the siderolabs skill has been removed from this repo. Manage it out-of-band if you need it.

Breaking change

skills-lock.json is removed. The siderolabs skill is temporarily unavailable pending an upstream rename to SKILL.md.

Related

Re-install each agent skill from its original upstream repo via
`gh skill install`, so every installed SKILL.md now carries
`metadata.github-*` frontmatter pointing at the true origin instead
of `devantler-tech/skills`. `gh skill update --all` reads that
metadata directly, making the sidecar `skills-lock.json` redundant.

- Delete `skills-lock.json`.
- Reinstall 11 of 12 skills from upstream via
  `gh skill install <owner/repo> <path> --agent github-copilot
   --scope project --dir .agents/skills`.
- `siderolabs/docs` is not re-installed: the upstream ships
  `public/skill.md` (lowercase) which `gh skill install` rejects
  (it only recognises `SKILL.md`). Tracking upstream for a fix —
  until then, manage that skill out-of-band or drop it.
- Bump `update-skills.yaml` to pin the refreshed reusable workflow and
  swap `skills-lock` for the new `dir` input.

BREAKING CHANGE: `skills-lock.json` is removed. The `siderolabs`
skill is temporarily unavailable pending an upstream rename to
`SKILL.md`.

Refs: devantler-tech/skills#16, devantler-tech/actions#95,
devantler-tech/reusable-workflows#207

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 19, 2026 16:10
@botantler botantler Bot enabled auto-merge April 19, 2026 16:10
@github-project-automation github-project-automation Bot moved this from 🫴 Ready to 🚀 In Finalization in 🌊 Project Board Apr 19, 2026
Comment thread .github/workflows/update-skills.yaml Fixed
@devantler devantler changed the title refactor(skills)!: reinstall from upstreams, drop skills-lock.json refactor(skills): reinstall from upstreams, drop skills-lock.json Apr 19, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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 refactors how Copilot agent skills are managed in-repo by removing the skills-lock.json sidecar and switching to upstream-installed skills whose SKILL.md frontmatter points at their real source, aligning with the newer “update from metadata + directory” workflow.

Changes:

  • Deleted skills-lock.json and updated the scheduled “update skills” workflow to target .agents/skills directly.
  • Reinstalled/updated multiple skills so their metadata.github-* frontmatter references upstream repos/refs instead of devantler-tech/skills.
  • Expanded/updated the gitops-knowledge skill content with new references (e.g., Terraform bootstrap, gitless image automation) and refreshed guidance.

Reviewed changes

Copilot reviewed 24 out of 24 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
skills-lock.json Removed the lockfile previously used to pin skills to a single upstream source.
.github/workflows/update-skills.yaml Updates the reusable workflow pin and switches inputs to use .agents/skills as the managed directory.
.agents/skills/siderolabs/SKILL.md Removes the SideroLabs skill from the repo.
.agents/skills/refactor/SKILL.md Updates skill provenance metadata to point at upstream.
.agents/skills/gitops-repo-audit/SKILL.md Updates skill provenance metadata to point at upstream.
.agents/skills/gitops-knowledge/SKILL.md Updates provenance metadata and refreshes top-level skill guidance.
.agents/skills/gitops-knowledge/evals/evals.json Adds/updates eval coverage for Terraform-based Flux Operator bootstrap guidance.
.agents/skills/gitops-knowledge/references/terraform-bootstrap.md Adds a Terraform bootstrap reference for Flux Operator.
.agents/skills/gitops-knowledge/references/sources.md Updates GitRepository guidance (e.g., sparseCheckout) and expands secret examples.
.agents/skills/gitops-knowledge/references/resourcesets.md Refreshes ResourceSet patterns and expands Permute guidance.
.agents/skills/gitops-knowledge/references/repo-patterns.md Generalizes repo naming in documented patterns.
.agents/skills/gitops-knowledge/references/kustomization.md Updates health-check/wait guidance for Kustomizations.
.agents/skills/gitops-knowledge/references/helmrelease.md Refreshes HelmRelease snippet(s) to match newer guidance.
.agents/skills/gitops-knowledge/references/gitless-image-automation.md Adds a new reference describing “gitless” image automation with ResourceSets.
.agents/skills/gitops-knowledge/references/flux-operator.md Updates Terraform guidance and adds OCI layerSelector details.
.agents/skills/gitops-knowledge/references/best-practices.md Reorders/adjusts best-practice bullets for Flux setups.
.agents/skills/gitops-cluster-debug/SKILL.md Updates skill provenance metadata to point at upstream.
.agents/skills/github-issues/SKILL.md Updates skill provenance metadata to point at upstream.
.agents/skills/github-actions-docs/SKILL.md Updates skill provenance metadata and refreshes routing guidance content.
.agents/skills/git-commit/SKILL.md Updates skill provenance metadata to point at upstream.
.agents/skills/gh-stack/SKILL.md Updates skill provenance metadata to point at upstream.
.agents/skills/gh-cli/SKILL.md Updates skill provenance metadata to point at upstream.
.agents/skills/find-skills/SKILL.md Updates provenance metadata and refreshes “skills discovery/install” guidance.
.agents/skills/copilot-instructions-blueprint-generator/SKILL.md Updates skill provenance metadata to point at upstream.

Comment thread .agents/skills/gitops-knowledge/SKILL.md
Comment thread .agents/skills/gitops-knowledge/references/sources.md
Comment thread .agents/skills/github-actions-docs/SKILL.md
The previous PR-head SHA was unreachable from the default branch after
reusable-workflows#207 squash-merged, triggering zizmor's
"commit with no history in referenced repository" alert. Repoint at
the merge commit on `main`.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@botantler botantler Bot added this pull request to the merge queue Apr 19, 2026
Merged via the queue into main with commit 9dae4d8 Apr 19, 2026
11 checks passed
@botantler botantler Bot deleted the devantler/lean-into-gh-skill-frontmatter branch April 19, 2026 16:21
@github-project-automation github-project-automation Bot moved this from 🚀 In Finalization to ✅ Done in 🌊 Project Board Apr 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

3 participants