README - Common DevX

Last Updated: 2026-02-26 by Keming He

Ready-to-use AI skills and human guides for consistent documentation, standardized workflows, and faster project setup. MIT licensed, zero dependencies.

What This Repository Contains

Directory	Purpose	Audience
.agents/skills/	AI-consumable skills for documentation tasks	AI agents
human-guides/	Reference docs, troubleshooting, workflows	Developers
.github/	Issue and PR templates (GitHub)	GitHub users
.gitlab/	Issue and MR templates (GitLab)	GitLab users

Quick Start

For AI Agents

Tell your agent:

Generate a commit message for my staged changes

Available skills: commit messages, issues, PRs/MRs, meeting memos, READMEs, and more. See .agents/skills/.

For Developers

Browse human-guides/ for:

• Git, shell, SSH, and GPG workflows (use-cases-*.md)
• Diagnostic procedures (diagnosis-*.md)

For Projects

Copy individual skill directories you need from .agents/skills/ and template files from .github/ or .gitlab/. This preserves your project-specific custom skills and workflows.

<!-- TODO: Add npx skills add KemingHe/common-devx install path (see #45) -->

Directory Structure

common-devx/
├── .agents/skills/        # AI skills
├── .github/               # GitHub templates
│   ├── ISSUE_TEMPLATE/    # Bug report, feature request
│   └── pull_request_template.md
├── .gitlab/               # GitLab templates
│   ├── issue_templates/   # Bug report, feature request
│   └── merge_request_templates/
├── human-guides/          # Developer guides (see human-guides/README.md)
├── CONTRIBUTING.md        # Development workflow
├── SECURITY.md            # Security and verification
├── LICENSE                # MIT license
└── README.md              # This file

References

• .agents/skills/ - AI skills directory
• human-guides/README.md - Guide index
• CONTRIBUTING.md - How to contribute
• SECURITY.md - Security guidance
• GitHub Issues - Questions and requests