skills.rest
Aveer
AveerCOMMUNITY
Explore all skills by this author →
GitHub

skills-maintenance

Create, edit, and sync agent skills to OpenCode and .agents deployment folders.

Updated Aug 16, 2026
Search Tags:#agent skills#sync#PowerShell#SKILL.md#frontmatter#opencode#repository maintenance
One-click install
npx skills add https://github.com/Aveer/skills --skill skills-maintenance-aveer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skills-maintenance
Source: https://github.com/Aveer/skills/tree/main/skills-maintenance
Command: npx skills add https://github.com/Aveer/skills --skill skills-maintenance-aveer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining a source-of-truth repository of agent skills requires consistent structure, valid SKILL.md frontmatter, and reliable propagation to multiple deployment targets. This Skill standardizes how skills are created, edited, removed, and mirrored so nothing drifts out of sync. ## Core Features & Use Cases - Skill Authoring Guidance: Defines the required SKILL.md format with YAML frontmatter (name, description) and rules for directory naming and README list updates. - Additive Sync Workflow: Documents the mirror-skills-opencode.ps1 and mirror-skills-agents.ps1 scripts that add or update skills in the OpenCode and cross-harness .agents folders without ever deleting target content. - Repo Maintenance Rules: Covers commit message conventions, pushing to origin, and previewing syncs with -WhatIf before propagating changes. - Use Case: You want to add a new code-review skill. Follow this Skill to scaffold the directory, write valid frontmatter, update the README skill list, commit, push, and mirror it to both deployment targets. ## Quick Start Ask the agent to create a new skill in the skills repository and sync it to both the OpenCode and .agents skills folders.

Frequently Asked Questions about skills-maintenance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new agent skill with SKILL.md?▼

Create a kebab-case directory under skills/ containing a SKILL.md file with YAML frontmatter defining name and description, followed by instruction body text. The name must match the directory name, and the skill should be added to the README skill list before committing and syncing.

How do I sync skills to OpenCode and the .agents folder?▼

Run mirror-skills-opencode.ps1 to sync to the OpenCode skills folder and mirror-skills-agents.ps1 to sync to the .agents folder. Both scripts are additive, copying new or changed files while never deleting anything from the targets.

Which AI tools read the .agents skills folder?▼

The .agents folder is read natively by Codex CLI, Cursor, Gemini CLI, VS Code/Copilot, and OpenCode in compatibility mode. Claude Code does not read it and instead uses its own ~/.claude/skills directory.

Can the mirror scripts delete skills from deployment targets?▼

No, the mirror scripts are strictly additive and never remove files or skills that exist only in the target folder. To retire a skill, delete it from the repo and manually remove its folder from each deployment target.

How do I preview skill sync changes before applying them?▼

Run either mirror script with the -WhatIf flag, such as .\mirror-skills-opencode.ps1 -WhatIf, to preview which skills would be added or updated without changing anything. You can also pass -TargetPath to mirror to a custom folder.

Related Skills

Explore More Software Engineering Skills→
Biswajit56546Biswajit56546

eda-system-packager

Package agent and skills infrastructure into a standalone repository-ready bundle.

Community
Advanced
Chachamaru127Chachamaru127
3.1k

harness-setup

Initializes Harness projects with CLAUDE.md, Plans.md, hooks, CI, and agent configuration.

Community
Advanced
projectbluefinprojectbluefin
11

example-skill

Provides a reusable template for authoring new skill definition files.

Official
Basic
vllm-projectvllm-project
5.1k

vllm-semantic-router-harness

Resolve primary skills and run harness validation in the vLLM Semantic Router repository.

Official
Intermediate