-
-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Labels
enhancementNew feature or requestNew feature or request
Description
Problem
The current 99problems skill can be improved in three areas:
- progressive disclosure can be tighter (keep
SKILL.mdlean 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.mdconcise 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.mdand define opt-in activation by copying it toreferences/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 optionalCONVENTIONS.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/99problemsin this issue. - No automatic file-copy mechanism for conventions activation in this phase.
Acceptance Criteria
SKILL.mdremains concise and under 500 lines.SKILL.mdclearly positions issue/PR history as a research avenue.- Optional subagent workflow is documented with evidence-based summary requirements.
CONVENTIONS_TEMPLATE.mdexists and is explicitly marked as inactive until copied toCONVENTIONS.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.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request