conventional-commits
Create Conventional Commits and PR titles that pass Cocogitto validation. Use when the user asks to commit, stage changes, split commits, write a commit message, open or update a PR title, or prepare squash-merge history.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 0
- Forks
- 2
01 前言 Front Matter
- name
- conventional-commits
- metadata
- { "tags": [ "git", "github", "workflow", "communication", "documentation" ], "author": "Marcio Altoé", "source": "https://github.com/marcioaltoe/skills", "version": "0.1.0", "category": "git" }
- description
- Create Conventional Commits and PR titles that pass Cocogitto validation. Use when the user asks to commit, stage changes, split commits, write a commit message, open or update a PR title, or prepare squash-merge history.
02 资源文件 1
03 SKILL.md 正文
Conventional Commits
Create commits and PR titles that are easy to review and pass cog verify.
Required format
Use Conventional Commits:
type(scope): imperative subject
The scope is optional:
fix: handle empty setup files
feat(setups): add rust CLI preset
docs(readme): clarify setup install commands
Allowed types
feat- user-facing feature or capabilityfix- bug fixrefactor- code change without behavior changedocs- documentation onlytest- tests onlychore- maintenance without runtime behavior changebuild- build tooling, dependencies, or packagingci- CI workflow changesperf- performance improvementstyle- formatting only, not visual UI changesrevert- revert a previous change
Subject rules
- Use imperative mood:
add,fix,remove,rename; notadded,fixed,removes. - Start lowercase after the colon.
- Do not end with a period.
- Keep the first line under 72 characters when possible.
- Describe the intent, not the file names.
Commit workflow
-
Inspect the working tree:
git status --shortgit diff --statgit diff
-
Decide commit boundaries.
- Split unrelated changes into separate commits.
- Split behavior, tests, docs, formatting, dependencies, and generated files when they are reviewable separately.
- If one file has mixed changes, use patch staging.
-
Stage only intended changes.
- Use
git add <path>for clean file boundaries. - Use
git add -pfor mixed hunks. - Review staged content with
git diff --cached.
- Use
-
Write the message.
- Choose the type from the allowed list.
- Add a scope when it helps review, usually the package, module, collection, or feature.
- Add a body only when the reason is not obvious.
- Use footers for
BREAKING CHANGE:,Refs #123, orCloses #123.
-
Validate when Cocogitto is available.
cog verify "$(git log -1 --pretty=%B)"- For a proposed title:
cog verify "$PR_TITLE"
-
Run the smallest relevant verification before committing, or use the repo's required verification command when one exists.
PR title rules
Pull request titles must also use Conventional Commits because squash merge often uses the PR title as the final commit message.
Before opening or editing a PR:
PR_TITLE='feat(setups): add Go CLI preset'
cog verify "$PR_TITLE"
If cog is not installed, still write the title in the exact Conventional Commit format and expect CI to validate it.
Examples
Good:
feat(auth): add token refresh flow
Good with body:
fix(cli): handle empty setup files
The installer previously treated an empty setup file as a successful install.
This now fails early with a clear error.
Bad:
update files
Bad:
fix: change setup line 42
Output
When asked to commit, report:
- commit boundaries chosen
- staged files for each commit
- final commit message
- verification command and result
04 同仓库更多 Skills
startup-validator
Comprehensive startup idea validation and market analysis tool. Use when users need to evaluate a startup idea, assess market fit, analyze competition, validate problem-solution fit, or determine market positioning. Triggers include requests to "validate my startup idea", "analyze market opportunity", "check if there's demand for", "research competition for", "evaluate business idea", or "see if my idea is viable". Provides data-driven analysis using web search, market frameworks, competitive research, and positioning recommendations.
positioning-icp
When the user wants to define their ideal customer profile, position an AI product, build messaging architecture, or validate product-market fit. Also use when the user mentions 'ICP,' 'ideal customer profile,' 'positioning,' 'PMF,' 'product-market fit,' 'messaging,' 'buyer persona,' 'enrichment signals,' 'market positioning,' or 'competitive positioning.' This skill covers market positioning, ICP definition, messaging architecture, and PMF validation for AI-native products. Do NOT use for technical implementation, code review, or software architecture.
copywriting
When the user wants to write or rewrite page copy (homepage, landing, pricing, feature), or asks which headline, promise, or message to lead with. Diagnoses the input first (blank brief, real voice, or point edit) and changes only what it calls for. Claims must be supportable; a declined claim names the evidence that would unlock it. No AI tells like 'it's not X, it's Y' or 'no X, no Y, no Z'. For editing, see copy-editing. For emails, see emails. For the offer, see offers.
business-storyteller
Transforms technical work into persuasive business-language documents for non-technical stakeholders, including internal announcements, approval proposals, incident explainers, technical-debt cases, product explainers, and investor or partner memos. Use when the user asks to present technical work to the company, explain software to business teams, write a business case, make an approval document, or convert a technical artifact into stakeholder communication in the requested language. Do not use for READMEs, specs, ADRs, external marketing pages, or customer-facing sales copy.
brand-storytelling
Help users craft compelling brand narratives. Use when someone is defining brand strategy, writing company positioning, creating pitch narratives, developing messaging frameworks, or trying to make their company story more memorable.
skill-creator
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.