Audit: prune cross-skill duplication and bottom-up sprawl - #1
Open
eggmasonvalue wants to merge 4 commits into
Open
Audit: prune cross-skill duplication and bottom-up sprawl#1eggmasonvalue wants to merge 4 commits into
eggmasonvalue wants to merge 4 commits into
Conversation
- bottom-up-analyst: extract Phase 6 13F/insider interpretation to references/guide_ownership_signals.md; replace re-documented hands' tool commands (transcripts, 13F, insider, breaking-news filing fetch) with intent + pointers; point the honesty gate + MCI QUIPS tale to pitch-like-lou instead of restating; tie the done-check to Lou's honesty gate (372 -> 279 lines). - pitch-like-lou: drop duplicated 'do not pad' negation (positive already stated). - signal-sweep: collapse description to one trigger per branch; positive routing in place of the 'Do NOT use' negation.
memo_template.md section 7 (Ownership) now points to guide_ownership_signals.md for interpretation and specifies only the memo's output structure, instead of restating the 13F/insider reading; section 6 compresses the Discount Rate Derivation spec to a named subsection + pointer to guide_valuation.md rather than duplicating the methodology.
- flip_buy_difficulty_analysis.md: prepend a callout marking it a human-facing design proposal for an unbuilt feature, so an agent that listdirs the skill ignores it. - special_situation.md: slim the third MCI/QUIPS retelling to a pointer to pitch-like-lou's inviolable rule (single source of truth for the tale). - memo_template.md: reframe 'do not pad a section' as the positive 'weight each section to the archetype'.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Audits the skill corpus against the
writing-great-skillsframework (predictability,information hierarchy, pruning) and applies the fixes. Scope:
SKILL.mdfiles and allsupporting markdown (excluding
pitch-like-lou/references/corpus/, which is verbatim sourcematerial). No script/behavior changes.
Findings addressed
Sprawl / progressive disclosure
bottom-up-analyst/SKILL.md: extracted Phase-6 13F/insider interpretation into a newdisclosed
references/guide_ownership_signals.md; the loop step is now a sharp completioncriterion + context pointer. 372 → 189 changed lines; the loop reads at a glance again.
Cross-skill duplication (single source of truth)
pitch-like-lou("the one inviolable rule");
bottom-up-analystandspecial_situation.mdpoint to itinstead of restating.
fetch, cache-path templates) from
bottom-up-analyst— the "hands" own those; theconductor keeps which/why, not how to type it.
memo_template.md§6 (discount-rate) and §7 (ownership) against the valuation andownership guides — the template specifies output structure and points; methodology lives
in the guides.
Description hygiene
signal-sweep: collapsed the description to one trigger per real branch (insider /screens / theme / conference) and replaced the "Do NOT use…" negation with positive
routing to the sibling skills.
Negations → positive
bottom-up-analyst,pitch-like-lou, andmemo_templatein favour of the positive "weight each section to the archetype/situation."Orphaned dev-note
signal-sweep/docs/flip_buy_difficulty_analysis.md(a proposal for an unbuilt feature):added a header marking it human-facing and off-limits to an agent running the skill, so a
curious
lsof the skill dir doesn't mistake the draft code for a live capability.Not changed (deliberately)
sec-edgar-skillguides and the sixbottom-up-analystarchetype files — assessed asexemplary disclosed reference (dense, non-obvious, co-located, no-op-free).
pitch-like-lou/references/corpus/— out of scope (verbatim VIC letters).Verification
ruff check .,ruff format --check .— pass.markdownlint-cli2— 0 issues across all changed files.