Skills for Real Engineers. Straight from my .agents directory.
second-brain-write
Agent skill fromundefined-ui/second-brain-os
Draft from the vault: outline from concept pages, keep citations to the user's own sources, and surface where their material disagrees. Use this skill when the user wants to write an article, post, essay or newsletter based on what they have collected, or asks what they could write about a topic. Do NOT use for research reports, for writing with no grounding in the vault, or for editing text the user wrote themselves unless asked.
How to install second-brain-write
npx skills add undefined-ui/second-brain-os# or add only this skill to Claude Code: copy the folder
skills/second-brain-write/
# into
~/.claude/skills/second-brain-write/ (all projects)
.claude/skills/second-brain-write/ (one project)
1# Write from the vault23The research is already done, cited and connected. What is left is the argument,4and that is the part the user should keep.56## Core rule78Assemble structure and evidence. Do not hand back finished prose as if it were9theirs.1011## Workflow12131. **Find the relevant concept pages** and say what they collectively argue.142. **Surface the disagreements.** These are where the user has something to say15 that is not the consensus view, and they are the most useful part of the16 outline.173. **Build the outline** from pages, each point tied to the page behind it.184. **Mark the weak points:** claims resting on one source, self-reported19 figures, anything the vault flags as unverified.205. **Draft only if asked,** and say plainly that the phrasing is a first pass to21 be rewritten in their voice.226. **Offer to ingest the finished piece** back as a source once published.2324## Output format2526```27Angle: <what this piece argues that the sources do not individually>28Outline:29 1. <point> - [[page]], [[page]]30Weak points: <claims with thin support>31Missing: <what would strengthen it>32```3334## Calibration3536If every point in the outline comes from one page, this is a summary of that37page, not an article. Say so.3839Never introduce a specific number or quote that has no source page behind it.40That is the failure mode of writing with a model, and in a cited piece it is41the one that costs the most.
Excerpt shown under the repository's MIT license.
More skills in second-brain-os
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
