List Tickets

Purpose

This skill provides commands for discovering and listing open tickets. Open tickets are those in

.ushabti/tickets/

that have not been archived.

Listing Open Tickets

Basic List Command

List all ticket files in

.ushabti/tickets/

:

ls .ushabti/tickets/*.yaml 2>/dev/null || echo "No tickets found"

This shows filenames only. Example output:

.ushabti/tickets/T0001-add-search-functionality.yaml
.ushabti/tickets/T0005-improve-error-messages.yaml
.ushabti/tickets/T0008-refactor-agent-roles.yaml

List with Details

Show ticket files with modification times:

ls -lh .ushabti/tickets/*.yaml 2>/dev/null || echo "No tickets found"

Extract Ticket IDs

Get just the ticket IDs:

ls .ushabti/tickets/T[0-9][0-9][0-9][0-9]-*.yaml 2>/dev/null | \
  sed -E 's/.*\/(T[0-9]{4})-.*/\1/' || echo "No tickets found"

Example output:

T0001
T0005
T0008

Count Tickets

Count how many open tickets exist:

ls .ushabti/tickets/*.yaml 2>/dev/null | wc -l

Reading Ticket Contents

To read a specific ticket:

cat .ushabti/tickets/T0001-*.yaml

To read all tickets (useful for searching):

for ticket in .ushabti/tickets/*.yaml; do
  echo "=== $ticket ==="
  cat "$ticket"
  echo ""
done

Important Notes

Exclusions

These commands explicitly ignore:

• Archived tickets: Files in

  .ushabti/tickets/.archived/

  are never listed
• Non-YAML files: Only

  .yaml

  files are considered tickets
• Subdirectories: Only files directly in

  .ushabti/tickets/

  are listed

Empty Directory

If no tickets exist, the commands handle this gracefully:

• ls

  with

  2>/dev/null

  suppresses error messages

• || echo "No tickets found"

  provides user-friendly output

Sorting

By default,

ls

sorts alphanumerically, which matches ticket ID order due to zero-padding (T0001, T0002, T0010).

Example Usage

Scenario: User asks "What tickets are open?"

Run:

ls .ushabti/tickets/*.yaml 2>/dev/null || echo "No tickets found"

If tickets exist, show filenames. If no tickets exist, respond "No tickets found".

Scenario: Agent needs to check if any tickets exist

Run:

ls .ushabti/tickets/*.yaml 2>/dev/null | wc -l

If result is 0, no tickets exist. If greater than 0, tickets exist.

Scenario: User asks for ticket details

Run:

for ticket in .ushabti/tickets/*.yaml; do
  echo "=== $ticket ==="
  cat "$ticket"
  echo ""
done

This displays all ticket contents with clear separation.

Integration with Other Skills

• Use

  find-next-ticket-number

  to determine the next ID when creating a ticket
• Use

  create-ticket

  to add a new ticket to the list
• Use

  archive-ticket

  to remove a ticket from the active list (moves to

  .archived/

  )
• Use

  describe-tickets

  to understand ticket schema and workflows

Output Format

The skill intentionally provides raw output (filenames, counts, YAML content) rather than formatted reports. This keeps the skill simple and allows agents to format output based on context.