issues-create

Create TOML issue files with computed IDs and stage them with git.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/glhewett/public-skills --skill issues-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: issues-create
Source: https://github.com/glhewett/public-skills/tree/main/issues-create
Command: npx skills add https://github.com/glhewett/public-skills --skill issues-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating and tracking lightweight issues in a git-native workflow can be error-prone and inconsistent when done manually; this Skill automates generating properly formatted issue files so teams maintain consistent metadata and history in the repository.

Core Features & Use Cases

  • Automated Issue Creation: Computes the next zero-padded 4-digit ID, writes a TOML file with id, title, priority, assigned_to, status, closed, and created_at fields, and appends a comments section placeholder.
  • Flag Parsing and Defaults: Accepts CLI-style flags for title, priority, assigned-to, and status, and falls back to sensible defaults when flags are omitted.
  • Git Integration: Stages the new issue file with git add to ensure the change is tracked and ready for commit.
  • Use Case: Quickly open a new bug or task from a natural-language instruction and have a consistent .issues/{id}.toml record created and staged.

Quick Start

Create a new issue titled Fix login bug with high priority assigned to alice by invoking the skill with flags --title Fix login bug --priority high --assigned-to alice.

Frequently Asked Questions about issues-create

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

FAQPage Schema
How do I create git-native issues as TOML files for issue tracking?▼

To create git-native issues, this skill writes a new .issues/{id}.toml file with metadata like title, priority, assigned_to, and status, then stages the file with git add. It computes the next zero-padded 4-digit ID automatically from existing files.

Can I set priority and assignment when creating issues in a git workflow?▼

Yes, you can set priority and assignment when creating issues by passing CLI-style flags like --priority and --assigned-to. If omitted, the skill falls back to sensible defaults when writing the TOML record.

What's the best way to automate issue management without a dedicated issue tracker?▼

Automating issue management without a dedicated tracker is handled by storing issues as lightweight TOML files in a git repository. This approach maintains consistent metadata, timestamps, and history directly in version control.

Does this issue creation method work with existing git repositories?▼

Yes, this method works with existing git repositories by operating within directories that store issues as .issues/{id}.toml files. It stages new issue files using git add so they are tracked and ready for commit.

What metadata fields are included in a TOML issue file?▼

The TOML issue file includes id, title, priority, assigned_to, status, closed, and created_at fields, along with a comments section placeholder. These fields ensure consistent issue tracking metadata across the repository.

How are issue IDs generated for TOML issue files?▼

Issue IDs are generated by computing the next zero-padded 4-digit number from existing issue files in the .issues directory. This ensures sequential, consistent identification for every new issue created.