OpenSkillIndex← back to search
claude-code

Awesome-omni-skill add-payee

Skill: Add Payee

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/tools/add-payee" ~/.claude/skills/diegosouzapw-awesome-omni-skill-add-payee && rm -rf "$T"
manifest: skills/tools/add-payee/SKILL.md
source content

Skill: Add Payee

Note: See 

AGENTS.md
and 
.github/instructions/agent-quickstart.instructions.md
for agent workflow rules and a concise checklist; use the Todo List Tool for multi-step tasks.

Note: See 

.github/instructions/developer-workflows.instructions.md
for canonical coding, testing, and formatting rules (type annotations, docstrings, 
__all__
, test conventions). See 
AGENTS.md
for agent workflow rules.

Payee directives must always be added to a 

preludes/
journal file, never to monthly or yearly journals. If you encounter a strict payee error (e.g., 'payee ... has not been declared'), resolve it by adding the payee to the appropriate 
preludes/
file as described below.

This skill describes how to add a new payee to the ledger system.

When to Use

  • When a new merchant, person, organization, or UUID payee is encountered in a transaction or needs to be registered for future use.

Example & guidance: See 

./examples.md
for a short example of adding a payee to 
preludes/self.journal
. Validate with 
pnpm run format
and 
pnpm run check
after adding.

Steps

  1. Determine the correct preludes file

    • All payee directives must be placed in a 
      preludes/
      journal file, never in a monthly or yearly journal.
    • Most payees go in 
      preludes/self.journal
      .
    • If the payee is specific to an alternative or other scenario, use the appropriate 
      preludes/*.journal
      file.

  2. Locate the payee section

    • Find the block of lines starting with 
      payee
      in the chosen preludes file.

  3. Insert the new payee

    • Add a line: 
      payee <payee-name-or-UUID>
    • Place the new payee in strict lexicographical (ASCII/Unicode) order within the payee section.
    • When adding, check the entire payee section for correct placement and move any out-of-order entries if found.

  4. Validation

    Note: Use the canonical formatting and validation workflow: see 

    .github/instructions/developer-workflows.instructions.md
    and 
    .github/instructions/common-workflows.instructions.md
    for steps and examples (prefer 
    pnpm run format
    and 
    pnpm run check
    ).

Anti-Patterns

  • Never add payees to monthly or yearly journals. Always use a 
    preludes/
    file.
  • Inserting payees out of order, or failing to correct existing order mistakes

Related Documentation