OpenParable
Skip to content
← Back to skills

Enrich Us

Productivity
enrich-us

Enrich Us is an Agent Skill for productivity published in the LIDR-academy/AI4Devs-LTI-extended repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Analyze and enhance Jira user stories with complete, implementation-ready technical detail.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/LIDR-academy/AI4Devs-LTI-extended/blob/HEAD/ai-specs/skills/enrich-us/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/enrich-us, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

enrich-us Skill

Use it when this workflow is required in the project.

Instructions

Please analyze and fix the Jira ticket: $ARGUMENTS.

Follow these steps:

  1. Use Jira MCP to get the ticket details, whether it is the ticket id/number, keywords referring to the ticket or indicating status, like "the one in progress"
  2. You will act as a product expert with technical knowledge
  3. Understand the problem described in the ticket
  4. Decide whether or not the User Story is completely detailed according to product's best practices: Include a full description of the functionality, a comprehensive list of fields to be updated, the structure and URLs of the necessary endpoints, the files to be modified according to the architecture and best practices, the steps required for the task to be considered complete, how to update any relevant documentation or create unit tests, and non-functional requirements related to security, performance, etc
  5. If the user story lacks the technical and specific detail necessary to allow the developer to be fully autonomous when completing it, provide an improved story that is clearer, more specific, and more concise in line with product best practices described in step 4. Use the technical context you will find in @documentation. Return it in markdown format.
  6. Save the enriched user story as a markdown file in the tmp/ folder at the project root (create the folder if it doesn't exist). Name the file <ticket-id>-enriched-us.md (e.g., LTI-42-enriched-us.md). The tmp/ folder is already in .gitignore.
  7. Update ticket in Jira, adding the new content after the old one and marking each section with the h2 tags [original] and [enhanced]. Apply proper formatting to make it readable and visually clear, using appropriate text types (lists, code snippets...).
  8. If the ticket status was "To refine", move the task to the "Pending refinement validation" column.