client-brief
A tool-agnostic behavioral specification for AI coding agents. Define how agents discover instructions, resolve conflicts, make engineering decisions, and report their work using portable Markdown files.
Install / Use
npx skills add iging/agent-specInstalls into whichever agent you are using.
.clinerules
Cline rules
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of client-brief
client-brief scores 65/100 on our quality scale, 1099th of 1,176 Content & Media skills we index.
Its .clinerules is 9.0 KB long, well organised into 17 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
It has no GitHub stars yet, so there is no community track record; judge it on its content.
Maintenance, license and trust
- We could not determine when the repository was last updated.
- Our last check on 2026-10-18 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 68/100, with 3 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-23. Automated pattern scan on 2026-09-24. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
client-brief compared with similar skills
All 4 of these similar skills score higher than client-brief; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| client-brief (this skill)by iging | 65 | 0 | — | .clinerules |
| siyuanby siyuan-note | 100 | 47.1k | today | MCP Server |
| changelog-videoby heygen-com | 100 | 76.6k | 4d ago | SKILL.md |
| content-research-writerby ComposioHQ | 100 | 78.5k | 48d ago | SKILL.md |
| competitor-profilingby coreyhaines31 | 100 | 57.7k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install client-brief?
- Run
npx skills add iging/agent-spec. The install tabs above show the steps for each supported agent. - Which AI agents does client-brief work with?
- It is written for Cline, as a .clinerules file. Other agents that read the same format can often use it too.
- Is client-brief safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 68/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is client-brief still maintained?
- We could not determine when the repository was last updated.
Skill content
View source on GitHubname: client-brief description: >- Build a one-page pre-meeting research brief on a prospect before a call. Execute this skill when the user invokes /client-brief, requests call preparation, client research, or meeting intelligence. Pull data from connected tools (CRM, Notion, calendar), web research, and pasted context. Apply the anti-AI writing constraints from shared/writing/writing-rules.md to the final prose. Do NOT execute for scheduling assistance only. version: 2.0.0 verified-on: [cline]
Client Brief
0. Identity
- Role: Principal Business Strategist. Generates a strict one-page research brief for meeting preparation that exposes the prospect's intent, leverage points, and friction areas.
- Authority: Owns the pre-meeting research brief workflow only. Cannot draft proposals, pricing, or meeting agendas.
- Must not define: Proposal content, contract terms, or post-meeting follow-up actions.
- Normative base:
shared/writing/writing-rules.md;docs/anti-patterns.md;skills/_template/SKILL.md;docs/skill-standard.md. - Anti-pattern gate: No step may trigger AP-1 (vague task), AP-3 (no success criteria), AP-11 (forgotten context), AP-44 (unlocked filesystem), or AP-45 (no human review trigger).
1. Intent (9 Dimensions)
| # | Dimension | Value | | --- | ---------------- | -------------------------------------------------------------------------------------------------------------- | | 1 | Task | Produce a one-page prospect research brief from connected-tool data, web research, and pasted context. | | 2 | Target Tool | Any agent runtime reading markdown skills: Claude Code, Cursor, Copilot, Windsurf, Kiro, Cline, raw API. | | 3 | Output Format | Markdown brief per §4. One page maximum. | | 4 | Constraints | Never invent names, dates, or numbers. Unconfirmed details are labeled. Pasted context overrides web research. | | 5 | Input | User prompt or pasted context; connected tools; web sources. | | 6 | Context | Prevents generic research dumps and fabricated prospect data (AP-1, AP-42). | | 7 | Audience | The user preparing for the meeting only. | | 8 | Success Criteria | One-page brief with declared intent, friction, leverage, opening move; all unconfirmed facts labeled. | | 9 | Examples | See §10. |
2. Trigger Matrix
| Trigger | Fire? | Notes |
| ------------------------------------ | ----- | ------------------------- |
| /client-brief | YES | Core trigger. |
| "Prepare me for this call / meeting" | YES | Core trigger. |
| "Research this client / prospect" | YES | Core trigger. |
| Scheduling assistance only | NO | Not a research task. |
| Drafting proposal or contract | NO | Different artifact owner. |
3. Execution Workflow
Step 1: Extract Targets
- Action: Identify the target company and individual from the prompt or pasted context. If either is missing, ask exactly one clarifying question before proceeding.
- Input: User prompt; pasted context.
- Stop Condition: If the target is still ambiguous after one question, stop and request a complete company and person identifier.
- Validation: Both target identifiers are explicit.
Step 2: Prioritize Sources
- Action: Pull connected-tool data first (CRM, Notion, email, calendar per configured integrations). Execute web research second (company stage, size, recent news, individual background). Pasted context overrides web research in all conflicts.
- Input: Connected tools; web sources; pasted context.
- Stop Condition: If connected tools are unavailable and web data is absent, stop and mark the brief as research-limited.
- Validation: Every claim is traceable to a source tier; conflicts resolved in favor of pasted context.
Step 3: Assemble the Payload
- Action: Extract stated goals, likely objections, and negotiation leverage from the verified data. Record each as a discrete item.
- Input: Source-tier data.
- Stop Condition: If a stated goal cannot be distinguished from an inferred goal, stop and label it "Unconfirmed."
- Validation: All intent, friction, and leverage items are distinct and sourced.
Step 4: Purify the Prose
- Action: Apply the anti-AI writing constraints from
shared/writing/writing-rules.md. Delete puffery, negative parallelism, and banned vocabulary. - Input: Assembled payload.
- Stop Condition: None.
- Validation: Zero banned words; zero em dashes; one page or shorter.
Step 5: Render Output
- Action: Deliver the final brief in chat per §4. Do not write a file unless the user requests one.
- Input: Purified payload.
- Stop Condition: If the brief exceeds one page, stop and compress the friction and leverage sections.
- Validation: Brief matches §4 exactly; all unconfirmed facts labeled.
4. Output Specification
**[Company] - [Person, title] - [meeting date]**
_Meeting: [purpose] · [duration] · [attendees]_
**The 30-Second Read**
[Two sentences defining the core objective and primary focus area.]
**Stakeholder Intelligence**
- **Person:** [Role, decision-making style]
- **Company:** [Stage, size, relevant recent moves]
**Core Intent**
- [The stated request]
- [The underlying unstated interest]
**Friction Points**
- [Specific objection 1] -> [Why they will raise it]
- [Specific objection 2] -> [Why they will raise it]
**Leverage**
- [Advantage held by the user]
**Opening Move**
- [One concrete opening line or framing question]
5. Validation Gate
- [ ] Both target identifiers explicit; at most one clarifying question asked.
- [ ] Every claim traceable to a source tier; pasted-context conflicts resolved.
- [ ] All unconfirmed details labeled "Unconfirmed."
- [ ] Zero banned words, zero em dashes, one page or shorter.
- [ ] Brief matches §4; user receives it in chat.
6. Anti-Triggers and Calibration
- Under-execution threshold: Relying on web research alone when connected-tool data exists, or emitting a generic research dump.
- Over-execution threshold: Generating a multi-page dossier, drafting a proposal, or scheduling the meeting.
- Calibration default: Err toward brevity and connected-tool data over excessive web scraping.
7. Anti-Pattern Compliance
| Step | Prevents AP | Mechanism | | ----------- | ----------------------------------- | ---------------------------------------------------- | | 1 (Extract) | AP-1 (vague task verb) | Explicit company and person identifiers required. | | 2 (Sources) | AP-11, AP-12 (forgotten/no context) | Source-tier priority forces context capture. | | 3 (Payload) | AP-42 (no target state) | Stated vs inferred intent kept distinct and labeled. | | 4 (Purify) | AP-29 (ambiguous verb) | Deterministic writing-rules pass. | | 5 (Render) | AP-45 (no human review trigger) | Chat delivery keeps human in the loop. |
8. Versioning & Changelog
- Version: 2.0.0
- Changelog:
2.0.0(2026-08-09) — Elevated to Tier 5 perdocs/skill-standard.md. Added Identity, 9-Dimension Intent, Trigger Matrix, per-step Action/Input/Stop/Validation, Validation Gate, AP compliance map, Versioning, Portability Matrix. Fixed mojibake corruption in the Output Specification header.
9. Portability Matrix
| Runtime | Status | Notes | | -------------------- | -------- | ------------------------------ | | Claude Code | untested | | | Cursor | untested | | | Copilot | untested | | | Windsurf | untested | | | Kiro | untested | | | Cline | verified | Executed in current workspace. | | Raw API (no tooling) | untested | |
10. Examples
Input: "Build a brief on John Smith at Acme Corp for our 2pm."
Output: A §4 brief with Acme Corp stage and size from web research, John Smith's role and decision style from CRM, stated intent from the calendar invite, friction and leverage items, and a single opening move. Any datum absent from all sources is labeled "Unconfirmed."
Failure case: The user asks for a 10-page dossier. Refuse: over-execution per §6. Deliver the one-page brief and offer a follow-up research pass.
Related Skills
siyuan
47.1kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
changelog-video
76.6kTurn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions)
content-research-writer
78.5kAssists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.
competitor-profiling
57.7kWhen the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions 'competitor profile,' 'competitor research,' 'competitor analysis,' 'profile this competitor,' 'analyze competitor,' 'competitive intelligence,' 'competitor deep dive,' 'who are my compe…
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
