Skip to content

Skills: progressive disclosure (short root SKILL.md plus reference files) #51

Description

@jernejk

The seven skill templates total about 1,060 lines and the larger ones (accounting 274, timesheets 215) carry full step-by-step recipes. Current guidance for frontier models is a minimal root that names the trigger and routes to supporting docs, loaded only when needed.

Proposal:

  • SkillRenderer gains multi-file output: SKILL.md (30 to 60 lines: trigger, run-first commands, hard rules) plus references/*.md for workflows and recipes.
  • Templates split accordingly; the root links each reference conditionally ("For invoice reconciliation see references/reconciliation.md").
  • tp skills create writes and updates the whole folder; the version check covers all files.

Descriptions were already tightened in #50.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Priority: P3Nice to haveType: RefactorA code quality improvement e.g. Tech debt

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions