Practical overview
When it fits
Use it when agent instructions, skills and local helpers need to be maintained centrally and exposed across several repositories or agent environments.
Who it is for
- Developers maintaining multiple local repositories.
- Teams standardizing instructions and reusable workflows for Codex- or Claude-style agents.
- Builders who need portable shell helpers or local skill validation.
Documented uses
- Share agent rules across repositories through pointer-style instruction files.
- Package reusable workflows in routable skill directories.
- Synchronize skills into the different local layouts expected by Codex and Claude Code.
- Validate skill metadata and maintain local workflow guardrails.
- Provide small shell and TypeScript helpers for recurring repository tasks.
Requirements & limits
The repository is public and identifies an MIT license. Its documented use is local and self-hosted through CLI-oriented scripts.
- The synchronization logic produces different layouts for Codex and Claude Code, including whole-root links for Codex and flat per-skill links for Claude Code.
- Skills require YAML front matter with
nameanddescription; descriptions are intended for routing rather than extensive documentation. - The repository preserves real files and directories during ordinary synchronization and reports destination conflicts.
- A local Git hook can use
git config core.hooksPath hooksto enable the documented hook directory. - The browser helper is standalone and includes commands for navigation, JavaScript evaluation, screenshots, console and network inspection, and content search.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Add and validate a repository-local agent skill
Make a new skill available to the repository’s skill-routing structure and validate its metadata.
Before you start
- A local checkout of Agent Scripts.
- A new directory under
skills/containing aSKILL.mdfile. - YAML front matter with
nameanddescriptionfields. - The repository’s
scripts/validate-skillshelper.
Steps
Create a new skill directory under
skills/.Add
SKILL.mdwith YAML front matter containing a name and short description.Keep the skill body terse and operational, placing repeatable commands in a
scripts/subdirectory when appropriate.Run
scripts/validate-skillsafter editing.
Expected outcome
The skill’s documented structure is checked for YAML front matter and the required name and description fields.
Guide limitations
- The source documents the file structure and validation step but does not demonstrate a complete runtime integration test.
- The evidence does not specify the full execution environment for local hooks.
Synchronize skills for Codex and Claude Code
Build the documented local skill mirrors and shared instruction pointers after cloning or adding skills.
Before you start
- A local checkout of Agent Scripts.
- The documented local workspace layout, including the relevant repository paths.
- Codex and/or Claude Code local skill locations.
Steps
Run
scripts/sync-skillsafter cloning or adding skills.Use the ordinary sync mode to build Codex whole-root links, Claude flat per-skill links and shared instruction pointers.
For the documented legacy nested topology, invoke
scripts/sync-skills --repair-nested-self-linkswith an explicit allowlist; add--dry-runfor the scoped preview mode.Review reported collisions, stale links or refused changes.
Expected outcome
The documented Codex and Claude skill mirrors and shared instruction pointers are synchronized while real destination files and directories are preserved.
Guide limitations
- Claude Code loads only one skill-directory level, so category subfolders are not scanned.
- Name collisions resolve in the documented order and may be skipped.
- Nested-link repair is not atomic concurrency protection; completed removals are not rolled back after a later error.
- The source documents setup and validation behavior, not a complete agent workflow execution.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 2 October 2026
- Original website title
- steipete/agent-scripts · Official homepage title · retained in its source language

