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.