Reporting LingTai Issues
This is a reference router. You use the LingTai system as a real user all day — its skills, capabilities, and procedures — so you are uniquely positioned to notice problems humans miss. When you notice something wrong, surface it. This skill is the protocol: enter through this router, pick the one nested reference matching where you are in the report lifecycle, and read that leaf for the full procedure.
The non-negotiables (read before anything else)
Two rules hold across every path and every leaf:
- Human consent is required, always. You never open a GitHub issue without an explicit "yes" from the human. The human is the accountable owner of what gets filed under their name. Even if
gh is authenticated and you have a shell, per-issue consent is non-negotiable. If they decline, drop it — no nagging, no auto-retry.
- Secrets never enter a report. No tokens, keys, or passwords in the body, in chat, in logs, or in files. A human-provided
GH_TOKEN stays in the env of the single command that needs it. Redact before you quote.
The nested references elaborate these; they never weaken them.
Nested reference catalog
- name: issue-report-evidence-checklist
location: reference/evidence-checklist/SKILL.md
description: When an observation is worth reporting (and when it isn't), what evidence to capture verbatim, and how to keep secrets out of the report.
- name: issue-report-report-template
location: reference/report-template/SKILL.md
description: The report skeleton — subject/title, the structured body sections, sending it via mail to your parent and the human, and which repo to target.
- name: issue-report-filing-flow
location: reference/filing-flow/SKILL.md
description: The filing decision — human consent boundary, the read-only gh probe, Path A (direct gh filing) and Path B (paste-ready handoff), token hygiene, and proactive surfacing.
Routing table
You will usually move through all three in order, but read one leaf at a time — don't pull the whole protocol into context at once.
| Where you are |
Read |
What it covers |
| Just noticed something |
reference/evidence-checklist/SKILL.md |
Whether it's report-worthy, the evidence to capture before it's gone, scrubbing secrets |
| Ready to write it up |
reference/report-template/SKILL.md |
The body/title structure, and mailing it to your parent and the human |
| Time to file |
reference/filing-flow/SKILL.md |
The read-only gh probe, the human's permission, then Path A filing or Path B handoff |
Found a bug or issue? If you encounter any problems with this skill, load the lingtai-issue-report skill and follow its instructions to report it.
1---2name: lingtai-issue-report3description: Protocol router for reporting bugs, stale info, missing capabilities, or design issues in any LingTai skill, capability, preset, or system behavior. Enter through this router, then load the one nested reference you need — evidence-checklist, report-template, or filing-flow. You always assemble a structured report and ask the human for permission before filing.4---56# Reporting LingTai Issues78This is a reference router. You use the LingTai system as a real user all day — its skills, capabilities, and procedures — so you are uniquely positioned to notice problems humans miss. **When you notice something wrong, surface it.** This skill is the protocol: enter through this router, pick the one nested reference matching where you are in the report lifecycle, and read that leaf for the full procedure.910## The non-negotiables (read before anything else)1112Two rules hold across every path and every leaf:13141. **Human consent is required, always.** You never open a GitHub issue without an explicit "yes" from the human. The human is the accountable owner of what gets filed under their name. Even if `gh` is authenticated and you have a shell, per-issue consent is non-negotiable. If they decline, drop it — no nagging, no auto-retry.152. **Secrets never enter a report.** No tokens, keys, or passwords in the body, in chat, in logs, or in files. A human-provided `GH_TOKEN` stays in the env of the single command that needs it. Redact before you quote.1617The nested references elaborate these; they never weaken them.1819## Nested reference catalog2021```yaml22- name: issue-report-evidence-checklist23 location: reference/evidence-checklist/SKILL.md24 description: When an observation is worth reporting (and when it isn't), what evidence to capture verbatim, and how to keep secrets out of the report.25- name: issue-report-report-template26 location: reference/report-template/SKILL.md27 description: The report skeleton — subject/title, the structured body sections, sending it via mail to your parent and the human, and which repo to target.28- name: issue-report-filing-flow29 location: reference/filing-flow/SKILL.md30 description: The filing decision — human consent boundary, the read-only gh probe, Path A (direct gh filing) and Path B (paste-ready handoff), token hygiene, and proactive surfacing.31```3233## Routing table3435You will usually move through all three in order, but read **one leaf at a time** — don't pull the whole protocol into context at once.3637| Where you are | Read | What it covers |38|---|---|---|39| Just noticed something | `reference/evidence-checklist/SKILL.md` | Whether it's report-worthy, the evidence to capture before it's gone, scrubbing secrets |40| Ready to write it up | `reference/report-template/SKILL.md` | The body/title structure, and mailing it to your parent and the human |41| Time to file | `reference/filing-flow/SKILL.md` | The read-only `gh` probe, the human's permission, then Path A filing or Path B handoff |4243---44> **Found a bug or issue?** If you encounter any problems with this skill, load the `lingtai-issue-report` skill and follow its instructions to report it.
lingtai-ai