faff-jot

Converts project ideas and feature requests into structured tracker tickets.

3|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/shftwst/faff --skill faff-jot-shftwst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: faff-jot
Source: https://github.com/shftwst/faff/tree/main/plugin/skills/faff-jot
Command: npx skills add https://github.com/shftwst/faff --skill faff-jot-shftwst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a loose idea, feature request, or bug report into well-shaped, actionable tracker tickets is inconsistent and time-consuming. This Skill provides a single front door for new work: it runs a discovery conversation, delegates shaping to the configured methodology, and creates confirmed tickets in the tracker so the rest of the delivery pipeline can pick them up. ## Core Features & Use Cases - New-work intake: Kick off a greenfield project or capture a single feature, bug, or idea, and turn it into a structured set of tracker tickets with templates, relationships, and provenance markers. - Existing-ticket shaping: Point it at an existing ticket (/faff-jot ISSUE-XX) to crank automation eligibility up or down, or apply the faff-automation-hold hard stop, via human-gated tracker label changes. - Delegated discovery and shaping: Discovery runs through the configurable intake slot and ticket structure through the methodology slot, so ticket shaping stays consistent with how the project's backlog is groomed. - Use Case: You have an idea for a new reporting feature. Run /faff-jot, describe it conversationally, review the proposed ticket tree, confirm, and the tickets are created in your tracker and chained to /faff-prep for specification. ## Quick Start Run /faff-jot and describe the new project, feature, or bug you want to capture, then confirm the proposed ticket structure to create it in your tracker.

Frequently Asked Questions about faff-jot

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

FAQPage Schema
How do I turn a feature idea into tracker tickets?▼

Run /faff-jot with no argument and describe the feature conversationally. The skill runs discovery through the configured intake slot, shapes the result into tickets via the methodology slot, shows you the proposed structure, and creates the tickets in the tracker only after you confirm.

How do I make an existing ticket eligible for automation?▼

Run /faff-jot with the ticket id, for example /faff-jot ISSUE-XX. The interactor checks the ticket's current eligibility labels and advises you to add or remove the faff-automate label in the tracker, since those labels are tracker-owned and never written by the tool itself.

Does faff-jot work without a tracker connection?▼

Yes, in git-only mode it still runs discovery and shaping, then writes the shaped ticket set to .faff/intake/ as a checklist with stable gitkey markers. Ticket creation is skipped and noted, so the discovery brief and structure are never lost.

Can faff-jot create tickets automatically without confirmation?▼

Only at full appetite for non-container tickets when the brief is unambiguous. Project and initiative containers always require human confirmation, and the skill never creates work autonomously since new scope entering the system is a human-gated decision.

What is the difference between faff-jot and faff-prep?▼

faff-jot handles intake: it discovers and creates backlog tickets with seeded descriptions. faff-prep runs later per ticket and turns a backlog item into a buildable specification. faff-jot never writes specs itself.