devops-skill
devops-skill
Agent skills for Git / GitHub / local task workflows and secret scanning.
Repository: qdriven/devops-skill · Docs site: GitHub Pages (auto-deploys on push to main). Local preview and build: How to build the docs site.
Switch language with 中文 / English in the sidebar options menu.
Choose the right documentation type
| If you want to… | Go to |
|---|---|
| Complete a first install and run a sample workflow | Tutorials |
| Perform a specific install or workflow command | How-to guides |
| Understand git-workflow vs local-workflow and no-hook design | Explanation |
| Learn how offline site search works and how to use it | Site search |
| Look up skills, agents, and script flags | Reference |
Skills at a glance
| Skill | Description |
|---|---|
git-workflow |
GitHub CLI task workflow (Issue as record → plan/execute → close) |
git-worktree |
Isolated/parallel development with git worktrees; pairs with the workflows above |
local-workflow |
Local task workflow (no GitHub; local tracing) |
docmd |
Scaffold/build a docs site from the bundled Diátaxis template (this site is the live example) |
github-cli-skill |
Lightweight GitHub CLI helper (repos, issues) |
gh-create-release |
Create GitHub Releases |
scanning-for-secrets |
Secret scanning (token patterns + optional pre-commit hook) |
Full catalog: Skills catalog.
Install overview
The install scripts support system (each agent’s global skills directory) and project (./.agents/skills/). Symlink install is available when this repo should stay the source of truth. Hooks are optional (--hooks).
- How to install (system)
- How to install (project)
- Flags and agent paths: Install flags, Agents and paths
Which workflow to use
| Situation | Prefer |
|---|---|
| Need GitHub Issue lifecycle | git-workflow |
| Local / offline / no GitHub | local-workflow |
| Isolated dirs / parallel branches | git-worktree (often combined with the above) |
Details: git-workflow vs local-workflow. Workflows work fully without hooks; hooks are optional reminders — see No-hook design.
Common starting points
- First time here → Install and run your first local task
- Install into an agent → How to install (system)
- Need GitHub Issue tracking → How to run git-workflow
- Offline / no GitHub → How to run local-workflow
- Isolated / parallel checkouts → How to develop with git worktree