SkillOps for VS Code

SkillOps is a Visual Studio Code extension that creates repository-scoped skills for Codex, Claude Code, and Gemini CLI. It generates platform-specific skill directories, keeps SKILL.md focused, and writes supporting references, scripts, and assets. Codex runs can also be reviewed with local run insights.

SkillOps works locally and does not upload project files, prompts, session logs, credentials, token usage, workspace metadata, or analytics.

SkillOps also reports Codex sessions that did not invoke a skill. These appear under No skill, while the Session dropdown provides the timestamped history for each separate session.

Useful links

• Product requirements
  • Defines the user workflow, generated skill structure, and out-of-scope product behavior.
• Architecture
  • Documents the boundaries between VS Code integration, skill generation, insights, and webview presentation.
• Development and release runbook
  • Describes local verification, packaging, clean-profile testing, and release preparation.

How to install

Build and install SkillOps as a VSIX:

npm ci
npm run package

Then install the generated extension from VS Code:

Visual Studio Code
→ Extensions
→ More Actions...
→ Install from VSIX...
→ Select skillops-0.1.0.vsix

How to use

Create a skill from the SkillOps Activity Bar view:

SkillOps
→ Codex, Claude, or Gemini
→ Create Skill

The extension creates the selected platform's project skill directory (.agents/skills/ for Codex, .claude/skills/ for Claude, or .gemini/skills/ for Gemini). A Codex skill contains:

.agents/
  skills/
    <skill-name>/
      SKILL.md
      references/
        instructions.md
        validation.md
        examples.md
      scripts/
      assets/
      agents/
        openai.yaml

Review token usage and efficiency after a Codex run:

SkillOps
→ Codex
→ Show Run Insights

The same platform-grouped actions are available from the Explorer context menu:

All actions are also available from the Command Palette.

Run Insights scans recent Codex JSONL sessions from the configured Codex home and shows token totals, input/output split, cached-token percentage, reasoning-token percentage, repository/search activity, rate-limit status, and session-size warnings. Skill runs are grouped by skill name; ordinary project sessions remain available under No skill, with separate timestamped history entries.

Run Insights reads <Codex home>/sessions/**/*.jsonl without modifying those files. Set skillops.insights.codexHome when Codex does not use ~/.codex.

Questions and Feedback?

Use GitHub Issues for bugs, workflow problems, and feature requests.

When reporting a problem, include:

• Visual Studio Code version
• SkillOps version
• operating system
• steps to reproduce
• expected and actual behavior

Contributing

See CONTRIBUTING.md for the development workflow and pull-request checklist. Before contributing, read:

• AGENTS.md
• Product requirements
• Architecture

Keep pull requests focused. Include what changed, why it changed, and how it was verified.

How to build

npm ci
npm run bundle
npm run package

The packaged artifact is created as skillops-<version>.vsix in the repository root.

How to run tests

Run the complete local check:

npm run check

Run individual checks with:

npm run format:check
npm run lint
npm run typecheck
npm test
npm run test:webview

How to develop in Visual Studio Code

1. Run npm ci.
2. Open this repository in Visual Studio Code 1.96 or newer.
3. Run npm run bundle.
4. Start the Run SkillOps Extension launch configuration.
5. Verify SkillOps in a disposable workspace.

Extension Verification

Before publishing, install the packaged VSIX in a clean Visual Studio Code profile and verify:

SkillOps → Codex → Create Skill
SkillOps → Claude → Create Skill
SkillOps → Gemini → Create Skill
SkillOps → Codex → Show Run Insights

Also verify the Command Palette and Explorer context-menu entries, generated skill contents, duplicate handling, Run Insights states, supported themes, resizing, and keyboard navigation.

Release

The first public release is 0.1.0. Release preparation and clean-profile verification steps are maintained in the development and release runbook.

License

Licensed under the Apache License, Version 2.0.