# cyber-skills: A Framework of Skills, Roles, and Workflows Designed for AI Agents

> cyber-skills is an open-source skill library and CLI tool that provides structured definitions of skills, roles, and workflows for AI agents (such as Claude Code, Cursor, Codex), helping teams establish consistent AI-assisted development practices.

- 板块: [Openclaw Llm](https://www.zingnex.cn/en/forum/board/openclaw-llm)
- 发布时间: 2026-05-29T19:45:20.000Z
- 最近活动: 2026-05-29T19:50:30.678Z
- 热度: 159.9
- 关键词: AI Agent, Skill Library, CLI Tool, Claude Code, Cursor, Codex, Workflow, Commit Discipline
- 页面链接: https://www.zingnex.cn/en/forum/thread/cyber-skills-ai
- Canonical: https://www.zingnex.cn/forum/thread/cyber-skills-ai
- Markdown 来源: floors_fallback

---

## Introduction / Main Floor: cyber-skills: A Framework of Skills, Roles, and Workflows Designed for AI Agents

cyber-skills is an open-source skill library and CLI tool that provides structured definitions of skills, roles, and workflows for AI agents (such as Claude Code, Cursor, Codex), helping teams establish consistent AI-assisted development practices.

## Original Author and Source

- Original Author/Maintainer: cyberuni
- Source Platform: GitHub
- Original Title: cyber-skills
- Original Link: https://github.com/cyberuni/cyber-skills
- Source Publish/Update Time: 2026-05-29T19:45:20Z

## Project Overview

cyber-skills is a skill library and CLI tool designed for AI agents, supporting mainstream AI programming assistants like Claude Code, Cursor, Codex. It provides a set of structured skill, role, and workflow definitions to help development teams establish consistent AI-assisted development practices. The core concept of the project is to encode the team's best practices through reusable skill definitions, enabling AI agents to maintain consistent development styles and quality standards across different projects.

## Skill Augmentations

cyber-skills introduces the concept of skill augmentations, allowing customization of skill behavior through a layered override mechanism:

1. `SKILL.md` — Base skill (lowest priority)
2. `SKILL.project.md` — Project-level override (team-shared, checked into the consuming project)
3. `SKILL.local.md` — Machine-local override (highest priority, gitignored)

Later layers extend and override previous layers. This design allows teams to customize based on project needs while keeping the base skills unchanged.

## Skill Placement Locations

Skills can be placed in different locations based on their usage scope:

| Placement Location | Path | Use Case |
|---------|------|---------|
| User-level | `~/.agents/skills/<name>/` | Personal skills across all projects |
| Project Private | `.agents/skills/<name>/` | Contributor tools limited to this repository |
| Project Public | `skills/<name>/` | Released with the package, installed by users via `npx skills add` |

## Skill Modes

cyber-skills defines three skill modes:

| Mode | Use Case |
|------|---------|
| Process | Multi-step workflows where sequence and decision-making matter |
| Tool | Consistent usage around tools, systems, or connectors |
| Standard | Skills that enforce tone, structure, format, or quality standards |

## Directory Structure

The cyber-skills codebase is organized as follows:

- `skills/` — Public skills released with the package, installed by users via `npx skills add cyberuni/cyber-skills`
- `.agents/skills/` — Internal repository skills for contributor workflows (changesets, security PRs, repository renaming), all must be marked `metadata: internal: true`
- `src/` — TypeScript source code; domain folders: `audit/`, `awesome/`, `commit/`, `governance/`, `hook/`, `skill/`
- `governances/` — Version-locked agent tool contracts released with the npm package, loaded via `cyber-skills governance show <name>`
- `docs/adr/` — Architecture Decision Records
- `docs/research/` — Background research linked from ADRs and governances (not loaded via CLI)
- `bin/cyber-skills.mjs` — Minimal tracking shim, delegates to `dist/cli.mjs`
- `dist/cli.mjs` — Single bundled CLI (gitignored, built by tsdown)

## CLI Tool

The `cyber-skills` CLI is used to register agent hooks and run scripts without adding it as a devDependency. In other repositories, use fixed npx calls with the exact version from `npm view cyber-skills version`. In this repository, build first, then use the local bin. The tool is idempotent.