skills.rest
f4ah6o
f4ah6oCOMMUNITY
Explore all skills by this author →
GitHub

bdg

Manage README badges within marker blocks for Rust, Node, and MoonBit repositories.

Updated Jan 29, 2026
Search Tags:#automation#readme#rust#github-actions#badges#node#moonbit
One-click install
npx skills add https://github.com/f4ah6o/bdg-rs --skill bdg-f4ah6o
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bdg
Source: https://github.com/f4ah6o/bdg-rs/tree/main/.agents/skills/bdg
Command: npx skills add https://github.com/f4ah6o/bdg-rs --skill bdg-f4ah6o

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

bdg prevents accidental edits to README files by detecting, adding, listing, and removing badges only inside a designated marker block so repository metadata and unrelated content remain unchanged.

Core Features & Use Cases

  • Detects project context: Inspects Cargo.toml, package.json, and moon.mod.json to infer project identity and registry targets.
  • Safe badge management: Adds or removes badges strictly inside the <!-- bdg:begin --> / <!-- bdg:end --> marker, with dry-run and JSON output for review.
  • CI and registry awareness: Detects GitHub Actions workflows and registry metadata (crates.io, npm) to suggest appropriate badges.
  • Use Case: Add repository version, license, and CI badges to a Rust or Node README without altering any other sections and preview changes before writing.

Quick Start

Use bdg to add recommended badges to the README managed block and preview the edits with a dry-run.

Frequently Asked Questions about bdg

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

FAQPage Schema
How do I add badges to a README without altering unrelated content?▼

You can add badges to a README safely by placing them inside a designated marker block. This ensures repository metadata and unrelated content remain completely unchanged during badge insertion and removal.

How do I manage Rust and Node README badges automatically using CI workflows?▼

You can manage Rust and Node README badges by detecting GitHub Actions workflows and project manifests like Cargo.toml or package.json. This allows the tool to suggest appropriate CI and registry badges for insertion.

Can I preview README badge changes before writing them to the file?▼

Yes, you can preview README badge changes before writing them by using a dry-run feature. This outputs the proposed edits for review, often supporting JSON output, to ensure precise and reversible modifications.

Does badge management work for MoonBit repositories?▼

Yes, badge management works for MoonBit repositories by detecting the moon.mod.json manifest. It infers the project identity and registry targets to safely add or remove badges within the designated marker block.

What is the safest way to remove badges from a README?▼

The safest way to remove badges from a README is to restrict edits strictly to a designated marker block. This prevents accidental edits to repository metadata and ensures only the targeted badges are removed safely.

Related Skills

Explore More Software Engineering Skills→
cyberpunk042cyberpunk042

foundation-ci

Generate a .github/workflows/ci.yml with lint, test, and build steps.

Community
Advanced
JylhisJylhis
1

rust-refactor-helper

Refactor Rust code with LSP-driven impact analysis and dry-run previews.

Community
Advanced
d-o-hubd-o-hub
4

dist-channel-selection

Select distribution channels for Rust crates, WASM npm, and CLI npm artifacts.

Community
Intermediate
flonatflonat
127

proof-readability

Inspect mathematical proofs for clarity and improve readability without altering correctness.

Community
Advanced