commit-docs

Create commits tagged with [skip-cd] for non-deploy file changes.

108|19|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/minorun365/marp-agent --skill commit-docs-minorun365
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-docs
Source: https://github.com/minorun365/marp-agent/tree/main/.agents/skills/commit-docs
Command: npx skills add https://github.com/minorun365/marp-agent --skill commit-docs-minorun365

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Commits that only change documentation, editor settings, or other non-deploy files can trigger unnecessary Amplify builds and consume time and resources; this Skill helps avoid those redundant deployments by creating commits annotated to skip CI/CD.

Core Features & Use Cases

  • Change detection: Identifies modified files and determines whether they affect deployment-sensitive paths such as src/, amplify/, or package.json.
  • Safe staging & commit: Stages only files considered safe for skipping deployment and constructs a commit message appended with [skip-cd].
  • Warnings for risky changes: Emits warnings and requires confirmation when deployment-critical files are included so users do not accidentally skip required builds.
  • Use Case: Updating README.md, docs/, or editor config files without triggering an Amplify build.

Quick Start

Use the commit-docs skill to create a [skip-cd] commit for documentation and config updates by detecting non-deploy file changes, staging them, and committing with a message like "Docs update [skip-cd]".

Frequently Asked Questions about commit-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I skip Amplify deployments for documentation only commits?

To skip Amplify deployments for non-deploy changes, you can create commits tagged with [skip-cd]. The skill detects modified files, filters out deployment-sensitive paths, stages eligible files, and commits with a [skip-cd] appended message.

How does a skip-cd commit work with AWS Amplify CI/CD pipelines?

A skip-cd commit works by appending the [skip-cd] tag to your commit message, which signals the Amplify CI/CD pipeline to bypass the build process. This prevents unnecessary deployments when only non-critical files are changed.

Can I use a skip-cd commit if I modified files in the src or amplify directories?

You should not use a skip-cd commit for src, amplify, or package.json modifications. The skill detects these deployment-sensitive paths, emits warnings, and requires confirmation to prevent accidentally skipping required builds.

What is the best way to commit editor config changes without triggering a build?

The best way to commit editor config changes without triggering a build is to stage only safe files and use a commit message appended with [skip-cd]. This targets non-deploy file updates specifically to bypass CI/CD.

What files are considered safe for a skip-cd commit?

Files considered safe for a skip-cd commit include documentation, editor settings, and metadata. The skill filters out deployment-sensitive paths like src/, amplify/, and package.json to ensure only eligible files are staged.