AGENT SKILL

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
所属仓库
marcioaltoe/skills
最近更新
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 capability
  • fix - bug fix
  • refactor - code change without behavior change
  • docs - documentation only
  • test - tests only
  • chore - maintenance without runtime behavior change
  • build - build tooling, dependencies, or packaging
  • ci - CI workflow changes
  • perf - performance improvement
  • style - formatting only, not visual UI changes
  • revert - revert a previous change

Subject rules

  • Use imperative mood: add, fix, remove, rename; not added, 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

  1. Inspect the working tree:

    • git status --short
    • git diff --stat
    • git diff
  2. 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.
  3. Stage only intended changes.

    • Use git add <path> for clean file boundaries.
    • Use git add -p for mixed hunks.
    • Review staged content with git diff --cached.
  4. 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, or Closes #123.
  5. Validate when Cocogitto is available.

    • cog verify "$(git log -1 --pretty=%B)"
    • For a proposed title: cog verify "$PR_TITLE"
  6. 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

marcioaltoe
marcioaltoe/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.

★ 0
marcioaltoe
marcioaltoe/skills

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.

★ 0
marcioaltoe
marcioaltoe/skills

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.

★ 0
marcioaltoe
marcioaltoe/skills

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.

★ 0
marcioaltoe
marcioaltoe/skills

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.

★ 0
marcioaltoe
marcioaltoe/skills

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.

★ 0