Home / tailcallhq / forgecode · .forge/skills/debug-cli/SKILL.md · GitHub

debug-cli skillA

debug-cli is agent-read markdown (skill) from tailcallhq/forgecode: Use when users need to debug, modify, or extend the code-forge application's CLI commands, argument parsing, or CLI behavior. This includes adding new commands, fixing CLI bugs, updating command options, or troubleshooting CLI-related issues..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified before it reaches your agent: the main file against the SHA-256 recorded here, the others against the git hashes of its source commit. The deterministic audit below grades the latest version, and the same checks always give the same file the same grade.

What the file says

# CLI Debug Skill

This skill provides a systematic workflow for debugging and verifying changes to the forge CLI application.

## Core Principles

1. **Always get latest docs first**: Run `--help` to see current commands and options
2. **Use `-p` for testing**: Test forge by giving it tasks with the `-p` flag
3. **Never commit**: This is for debugging only - don't commit changes
4. **Clone conversations**: When debugging conversation bugs, clone the source conversation before reproducing

## Workflow

### 1. Build the Application

Always build in debug mode after making changes:

```bash
cargo build
```

**Never** use `cargo build --release` for debugging - it's significantly slower and unnecessary for verification.

### 2. Get Latest Documentation

**Always** start by checking the latest help to understand current commands and options:

```bash
# Main help - do this first
./target/debug/forge --help

# Command-specific help
./target/debug/forge [COMMAND] --help

# Subcommand help
./target/debug/forge [COMMAND] [SUBCOMMAND] --help
```

### 3. Test with `-p` Flag

Use the `-p` flag to give forge a task to complete without interactive mode:

```bash
# Test with a simple prompt
…

Read the whole file at its exact version.

How to install

Latest version
mdr add tailcallhq/forgecode/debug-cli@git:20251129.d8cba1f
Exact content
mdr add tailcallhq/forgecode/debug-cli@sha256:5a67fb126d8cfd64

Pin to a label to follow the author's releases, or to a sha256 for exact bytes. Either way the resolved hash is written to mdr.lock, and mdr install fetches those bytes again and checks them, so it installs them exactly or fails.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_wxlb3oorbsjdvbly.svg)](https://markdownregistry.com/a/art_wxlb3oorbsjdvbly)

2 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20251129.d8cba1f latest2025-11-29 d8cba1f 6,542 BA view · diff
git:20251124.2b8f2122025-11-24 2b8f212 6,588 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6542 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

tailcallhq/forgecode · 7,637 stars · license Apache-2.0 · pushed 2026-09-26 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wxlb3oorbsjdvbly
GET https://markdownregistry.com/api/v1/resolve?ref=tailcallhq/forgecode/debug-cli
GET https://markdownregistry.com/api/v1/blob/5a67fb126d8cfd6445468b20fad7ec98ff18b1b4d8503d3af1958e670d3fed6a

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from tailcallhq/forgecode

create-agent skill
tailcallhq/forgecode · .forge/skills/create-agent/SKILL.md · Create new agents for the code-forge application. Agents are stored as .md files in the <cwd>/.forge/agents directory…
git:20260126.0427bf8 · audit A · 7,637 stars
create-command skill
tailcallhq/forgecode · .forge/skills/create-command/SKILL.md · Create new commands for the code-forge application. Commands are stored as .md files in the <cwd>/.forge/commands…
git:20260126.0427bf8 · audit A · 7,637 stars
create-github-issue skill
tailcallhq/forgecode · .forge/skills/create-github-issue/SKILL.md · Create GitHub issues using GitHub CLI with support for templates, labels, assignees, milestones, and draft issues. Use…
git:20260212.ac26e78 · audit A · 7,637 stars
create-plan skill
tailcallhq/forgecode · .forge/skills/create-plan/SKILL.md · Generate detailed implementation plans for complex tasks. Creates comprehensive strategic plans in Markdown format with…
git:20251211.d9b44e8 · audit A · 7,637 stars
github-pr-comments skill
tailcallhq/forgecode · .forge/skills/github-pr-comments/SKILL.md · Resolve inline code review comments on a GitHub PR. Use when asked to "resolve review comments", "address PR feedback"…
git:20260402.238a5b9 · audit A · 7,637 stars
post-forge-feature skill
tailcallhq/forgecode · .forge/skills/post-forge-feature/SKILL.md · Generate a Twitter/X post highlighting a Forge feature. Use when the user asks to write a tweet, create a Twitter post…
git:20260321.bba73fb · audit A · 7,637 stars
resolve-conflicts skill
tailcallhq/forgecode · .forge/skills/resolve-conflicts/SKILL.md · Use this skill immediately when the user mentions merge conflicts that need to be resolved. Do not attempt to resolve…
git:20251127.ee24908 · audit A · 7,637 stars
resolve-fixme skill
tailcallhq/forgecode · .forge/skills/resolve-fixme/SKILL.md · Find all FIXME comments across the codebase and fully implement the work they describe. Use when the user asks to fix…
git:20260413.7ca79c7 · audit A · 7,637 stars
test-reasoning skill
tailcallhq/forgecode · .forge/skills/test-reasoning/SKILL.md · Validate that reasoning parameters are correctly serialized and sent to provider APIs. Use when the user asks to test…
git:20260402.1e409fa · audit A · 7,637 stars
write-release-notes skill
tailcallhq/forgecode · .forge/skills/write-release-notes/SKILL.md · Generate engaging, high-energy release notes for a given version tag. Fetches the release from GitHub, retrieves every…
git:20260413.a1642f4 · audit A · 7,637 stars
AGENTS.md agents
tailcallhq/forgecode · AGENTS.md
git:20251208.4905ae0 · audit A · 7,637 stars
minimal-skill skill
tailcallhq/forgecode · crates/forge_repo/src/fixtures/skills_with_resources/minimal-skill/SKILL.md · A minimal skill with no resources
git:20251124.2b8f212 · audit B · 7,637 stars

Every file in tailcallhq/forgecode

Browse by kind, by grade A, or by owner.