Skip to content

secondsky/claude-skills / plugins/unknowns-discovery/skills/unknowns-discovery

unknowns-discovery

Verified

Discover and reduce task unknowns — blindspots, missing context, and unknown unknowns — before committing to a plan, implementation, review, or merge.

references/SOURCE_INDEX.md

View on GitHub
# Source Index

## Primary source used for extraction

- Full article text supplied by the user in this chat on 2026-07-05.
- Original URL provided by the user: `https://x.com/trq212/status/2073100352921215386`
- Title from the supplied text/context: **A Field Guide to Fable: Finding Your Unknowns**
- Author/account from the supplied URL/context: Thariq (`@trq212`)

The package does not reproduce the article verbatim. It converts the article into a reusable agent skill.

## Public companion examples

- Companion index: `https://thariqs.github.io/html-effectiveness/unknowns/`
- The companion site presents eleven HTML artifacts across pre-implementation, during-implementation, and post-implementation unknown discovery patterns.

## Companion examples mapped to this skill

| Companion example | URL | Skill mode |
|---|---|---|
| Blindspot pass | `https://thariqs.github.io/html-effectiveness/unknowns/01-blindspot-pass.html` | `blindspot-pass` |
| Teach me my unknowns | `https://thariqs.github.io/html-effectiveness/unknowns/02-color-grading-explainer.html` | `teach-me-my-unknowns` |
| Four design directions | `https://thariqs.github.io/html-effectiveness/unknowns/03-design-directions.html` | `brainstorm-prototype` |
| Mock before you wire | `https://thariqs.github.io/html-effectiveness/unknowns/04-toolbar-mock.html` | `mock-before-wire` |
| Brainstorm the intervention | `https://thariqs.github.io/html-effectiveness/unknowns/05-churn-brainstorm.html` | `option-space-brainstorm` |
| The interview | `https://thariqs.github.io/html-effectiveness/unknowns/06-interview.html` | `one-question-interview` |
| Point at a reference | `https://thariqs.github.io/html-effectiveness/unknowns/07-reference-port.html` | `reference-semantics-map` |
| The tweakable plan | `https://thariqs.github.io/html-effectiveness/unknowns/08-implementation-plan.html` | `tweakable-plan` |
| Implementation notes | `https://thariqs.github.io/html-effectiveness/unknowns/09-implementation-notes.html` | `implementation-notes` |
| The buy-in doc | `https://thariqs.github.io/html-effectiveness/unknowns/10-pitch-doc.html` | `buy-in-doc` |
| Quiz me before I merge | `https://thariqs.github.io/html-effectiveness/unknowns/11-change-quiz.html` | `merge-readiness-quiz` |

## Agent Skill format references

- Open Agent Skills specification: `https://agentskills.io/specification`
- OpenAI Codex Agent Skills docs: `https://developers.openai.com/codex/skills`
- Anthropic Agent Skills overview: `https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview`
- Anthropic Skill authoring best practices: `https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices`

## Transformation notes

- The article’s conceptual flow became the skill’s activation rules and artifact selector.
- The article’s prompts became generalized prompt cards.
- The companion examples became named skill modes.
- The output schemas and validation scripts were added to make the skill operational in agent runtimes.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall