Problem
The current 99problems skill can be improved in three areas:
- progressive disclosure can be tighter (keep
SKILL.md lean and shift details to references),
- research positioning is implicit (issue/PR retrieval should be clearly framed as a viable research avenue for topic discovery),
- organization-specific query conventions need a cleaner opt-in mechanism.
Design
Refine the template skill to:
- keep
SKILL.md concise and focused on core workflow,
- explicitly state that issue/PR context retrieval is valid for research tasks (in addition to source-file inspection and web search),
- add an optional subagent-based research workflow for context-budget efficiency,
- add
references/CONVENTIONS_TEMPLATE.md and define opt-in activation by copying it to references/CONVENTIONS.md.
Scope
- Update
templates/skills/99problems/SKILL.md.
- Add
templates/skills/99problems/references/CONVENTIONS_TEMPLATE.md.
- Add clear progressive-disclosure load guidance for
REFERENCE.md, FORMS.md, and optional CONVENTIONS.md.
- Document evidence expectations for subagent summaries (IDs/keys and commands/queries used).
Boundary
- No runtime CLI/provider behavior changes.
- No direct edits to generated
.agents/skills/99problems in this issue.
- No automatic file-copy mechanism for conventions activation in this phase.
Acceptance Criteria
SKILL.md remains concise and under 500 lines.
SKILL.md clearly positions issue/PR history as a research avenue.
- Optional subagent workflow is documented with evidence-based summary requirements.
CONVENTIONS_TEMPLATE.md exists and is explicitly marked as inactive until copied to CONVENTIONS.md.
- Conventions template includes org query/label/status fields and a "no secrets" note.
Context
This improves skill quality and context efficiency while staying aligned with Agent Skills progressive-disclosure guidance.
Problem
The current
99problemsskill can be improved in three areas:SKILL.mdlean and shift details to references),Design
Refine the template skill to:
SKILL.mdconcise and focused on core workflow,references/CONVENTIONS_TEMPLATE.mdand define opt-in activation by copying it toreferences/CONVENTIONS.md.Scope
templates/skills/99problems/SKILL.md.templates/skills/99problems/references/CONVENTIONS_TEMPLATE.md.REFERENCE.md,FORMS.md, and optionalCONVENTIONS.md.Boundary
.agents/skills/99problemsin this issue.Acceptance Criteria
SKILL.mdremains concise and under 500 lines.SKILL.mdclearly positions issue/PR history as a research avenue.CONVENTIONS_TEMPLATE.mdexists and is explicitly marked as inactive until copied toCONVENTIONS.md.Context
This improves skill quality and context efficiency while staying aligned with Agent Skills progressive-disclosure guidance.