README - Common DevX

Last Updated: 2026-03-21 by Keming He

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

[!TIP]

For background, see the official agent skills documentation.

Repository Structure

common-devx/
├── .agents/skills/        # AI skills (see catalog below)
├── .github/               # GitHub issue and PR templates
├── .gitlab/               # GitLab issue and MR templates
├── human-guides/          # Developer guides
├── CONTRIBUTING.md        # How to contribute
├── LICENSE                # MIT license
├── README.md              # This file
└── SECURITY.md            # Security guidance

Available Skills

Skill	Category	Description
Commit Message Creation	⚙️ Git Workflow	Generate conventional commit messages following project standards
GitLab Sync	⚙️ Git Workflow	Sync .github/ and .gitlab/ template directories with platform-specific transformations
Issue Creation	⚙️ Git Workflow	Generate issues following repository templates for GitHub or GitLab
Pull/Merge Request Creation	⚙️ Git Workflow	Generate PR (GitHub) or MR (GitLab) descriptions following repository templates
Contacts Management	📁 Project Management	Manage contact information by adding, updating, or validating entries
Documentation Review	📁 Project Management	Review and correct documentation for consistency, correctness, and drift
Living Design Documents	📁 Project Management	Create and maintain structured design documentation that drives development
Meeting Agenda Creation	📁 Project Management	Generate meeting agendas with topics, timing, and preparation requirements
Meeting Memo Creation	📁 Project Management	Generate meeting memos capturing decisions, actions, and key discussions
README Creation	📁 Project Management	Generate self-contained README files that enable instant developer onboarding
Senior Mentor	🧠 Meta	Transform into a senior mentor for guided learning through Socratic questioning
Skill Creation	🧠 Meta	Create or refactor Agent Skills following the agentskills.io specification

Note: Emojis in this table are a deliberate exception to the project's no-emoji convention, used here to aid visual scanning of skill categories.

How to Use

Option 1: Copy Skills to Your Project

Copy skill directories from .agents/skills/ to your project. Most AI coding agents support the .agents/skills/ path:

# Copy a single skill (create directory if needed)
mkdir -p /path/to/your-project/.agents/skills
cp -r .agents/skills/commit-message-creation /path/to/your-project/.agents/skills/

# Copy all skills (warning: overwrites existing skills with same names)
mkdir -p /path/to/your-project/.agents/skills
cp -r .agents/skills/* /path/to/your-project/.agents/skills/

For Cursor, also supported: .cursor/skills/ (project) or ~/.cursor/skills/ (global).
For Claude Code, also supported: .claude/skills/ (project) or ~/.claude/skills/ (global).
For other agents, see the vercel-labs/skills supported agents list.

Option 2: Use as GitHub Template

Click Use this template (green button, top right) to create a new repository with all skills and guides included.

[!TIP]

Or use this direct link: Create from template.

Human Guides

Developer reference docs for common workflows and troubleshooting. See human-guides/README.md for naming conventions and how to add new guides.

Diagnosis

Terraform State Migration - investigation procedures for state migration issues

Use Cases

Git - command-line workflows
Git-crypt - transparent file encryption
GPG Commit Signing - signing commits with GPG
Shell - shell operations
SSH Authentication - Git and server authentication

References

CONTRIBUTING.md - How to contribute
SECURITY.md - Security guidance
GitHub Issues - Questions and requests