How to use the Deep Insight Writing Rules agent skill

What is an agent skill and what does this one do?

An agent skill is a folder of instructions that an AI agent can load when a task matches it. This skill lives in a single file, SKILL.md, and contains four writing rules for analysis articles.

Once installed, the agent picks a topic that has a verifiable question and a defined audience, and avoids vague big-picture framing. It leads with the core conclusion, backs each section with facts, data, cases, or comparisons, and keeps the author's opinions separate from sourced facts. It ends with practical advice or signals to watch, rather than repeating the article's summary.

• Topic: a verifiable question, a defined audience, and a judgment that adds new information.
• Structure: core conclusion first, then layered argument.
• Body: two to four main sections, each answering one specific question.
• Ending: actionable advice or follow-up signals, not a recap.

Install the skill from the ZIP download

Download the ZIP for the skill from this page and unzip it. The package contains SKILL.md. Then place the unzipped folder in one of the two locations the source supports: a personal skills folder at ~/.claude/skills/, or a project folder at .claude/skills/ inside your project.

If you use the Claude apps instead, you can upload the skill under Settings → Capabilities → Skills rather than placing files on disk.

• Personal install: ~/.claude/skills/
• Project install: .claude/skills/ in your project folder
• Claude apps: Settings → Capabilities → Skills, then upload

How to trigger the skill with natural requests

You do not need a special command. Describe the kind of piece you want in plain language, especially if it is a multi-section analysis, commentary, or research-style article. The skill is written for those tasks, so a request that names the type of writing is the most reliable trigger.

Adding your audience and the question the article should answer helps the agent apply the first rule, which asks for a verifiable question and a defined audience.

• "Draft an in-depth analysis for product managers on whether our churn data supports a pricing change."
• "Write a research-style report for students that separates the evidence from the author's opinions."
• "Outline a commentary piece with the conclusion first, then three sections, ending with signals to watch."

Examples of what the rules change in practice

Without the rules, an agent may open with background, bury its conclusion, or blend opinion into facts. With the skill loaded, the requested draft should open with the core conclusion and keep each section tied to a specific question.

Editors can use the same rules to make drafts from different agents or writers more consistent, since the structure and the fact-versus-opinion split are defined in one place.

Requirements, scripts and network use

The source lists no required software, does not say the skill runs scripts, and does not say it uses the network. The skill is a set of written instructions only.

The skill sets style and structure. It does not check sources. The agent or you must still verify every claim, figure, and citation before publishing.

• Requires: nothing listed
• Runs scripts: no
• Uses network: no
• Accuracy: not checked by the skill; verify facts yourself

Tips for getting better results

Give the agent the sources you want used, and ask it to mark which statements come from them and which are the author's judgment. The skill asks for this separation, but the agent needs material to separate.

Keep requests to multi-section pieces. For a short social post or a quick answer, the rules are more than the task needs.

• Supply your source documents or data in the conversation before drafting.
• Ask for two to four main sections, each with one question.
• Request a final section with concrete next steps or indicators to monitor.