惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Threat Intelligence Blog | Flashpoint
Threat Intelligence Blog | Flashpoint
W
WeLiveSecurity
O
OpenAI News
N
News and Events Feed by Topic
K
KPMG report finds enterprise disconnect between AI and its ROI | CIO
cs.CV updates on arXiv.org
cs.CV updates on arXiv.org
Webroot Blog
Webroot Blog
Google Online Security Blog
Google Online Security Blog
云风的 BLOG
云风的 BLOG
N
News | PayPal Newsroom
H
Hacker News: Front Page
博客园_首页
Exploit-DB.com RSS Feed
Exploit-DB.com RSS Feed
The Last Watchdog
The Last Watchdog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
H
Heimdal Security Blog
cs.AI updates on arXiv.org
cs.AI updates on arXiv.org
S
Schneier on Security
宝玉的分享
宝玉的分享
H
Hackread – Cybersecurity News, Data Breaches, AI and More
Recent Commits to openclaw:main
Recent Commits to openclaw:main
Y
Y Combinator Blog
Cyberwarzone
Cyberwarzone
Microsoft Security Blog
Microsoft Security Blog
C
CXSECURITY Database RSS Feed - CXSecurity.com
GbyAI
GbyAI
Cloudbric
Cloudbric
TaoSecurity Blog
TaoSecurity Blog
人人都是产品经理
人人都是产品经理
P
Palo Alto Networks Blog
M
MIT News - Artificial intelligence
G
GRAHAM CLULEY
C
Check Point Blog
Apple Machine Learning Research
Apple Machine Learning Research
Last Week in AI
Last Week in AI
T
Troy Hunt's Blog
L
Lohrmann on Cybersecurity
www.infosecurity-magazine.com
www.infosecurity-magazine.com
P
Proofpoint News Feed
Blog — PlanetScale
Blog — PlanetScale
量子位
博客园 - 聂微东
S
Securelist
博客园 - 三生石上(FineUI控件)
F
Full Disclosure
G
Google Developers Blog
L
LINUX DO - 热门话题
P
Proofpoint News Feed
AI
AI
PCI Perspectives
PCI Perspectives

Hacker News - Newest: "AI"

AI can't read an investor deck AI as an attorney? Student uses ChatGPT, Gemini to sue UW over alleged racial discrimination Hacking MCP Servers in AI Systems – The Rug Pull: Tool Changes After Approval GitHub - MeepCastana/KubeezCut: Free Web based video editor GitHub - GenAI-Gurus/awesome-eu-ai-act: Curated tools, official sources, OSS, templates, and guides for EU AI Act compliance. Can AI judge journalism? A Thiel-backed startup says yes, even if it risks chilling whistleblowers Coming soon: 10 Things That Matter in AI Right Now DARPA built an AI to fact-check enemy weapons claims What explains heterogeneity in AI adoption? When AI Meets Muscle: Context-Aware Electrical Stimulation Promises a New Way to Guide Human Movements - Department of Computer Science AI Changed How We Build. It Did Not Change What Matters. Linux rules on using AI-generated code - Copilot is OK, but humans must take 'full responsibility for the… Meta spins up AI version of Mark Zuckerberg to engage with employees Code Mode: Let Your AI Write Programs, Not Just Call Tools | TanStack Blog GitHub - Delavalom/graft: Go framework for building AI agents. Type-safe tools, multi-provider (OpenAI, Anthropic, Gemini, Bedrock), zero vendor SDKs. India's TCS tops estimates, says new AI models did not dent services demand Gen Z's fading AI hype Strong feeling: we are in a folded AI reality GitHub - machinarii/total-recall-catalog: A reference catalog of latest knowledge retrieval, memory & RAG systems GitHub - mensfeld/code-on-incus: Give each AI agent its own isolated machine with root, Docker, and systemd. Active defense detects and stops threats automatically.. Quantization, LoRA, and the 8% Problem: Benchmarking Local LLMs for Production AI Iran war: We spoke to the man making Lego-style AI videos that experts say are powerful propaganda Powell, Bessent discussed Anthropic's Mythos AI cyber threat with major U.S. banks GitHub - immartian/bellamem: Persistent belief-graph memory for AI agents. Retrieves decisive context by importance — not recency, not RAG, not /compact. recursive-mode: The Repo-Native Operating System for AI Engineering After the attack on Sam Altman's home, will AI CEO's go on the offensive? The biggest advance in AI since the LLM Opus 4.6 vs GPT 5.4 One Prompt Unity World Generation Test “AI polls” are fake polls Client Challenge Can AI be a 'child of God'? Inside Anthropic's meeting with Christian leaders How to Switch AI Chatbots and Why You Might Want To GitHub - MattMessinger1/agentic_refund_guardrail: Safe refund policy layer for AI agents — Python + TypeScript. Same behavior, shared tests. Adam/papers/emergent_values_whitepaper.md at master · strangeadvancedmarketing/Adam Ask HN: How do you stop playing 20 questions with your AI coding tools How far can automation and AI support psychotherapy? - @theU GitHub - stagas/rtdiff: realtime git diff gui and AI-assisted commits A Mac Studio for Local AI — 6 Months Later A History of the Early Years of AI at the University of Edinburgh Why AI Coding Tools Still Feel Stuck on Localhost MSN AI Datacenters Are Becoming Strategic Targets twitter.com Penn Researchers Use AI to Surface Unreported GLP-1 Side Effects in Reddit Posts Show HN: MoodSense AI (ML and FastAPI and Gradio, Deployed on Hugging Face) Moodsense Ai - a Hugging Face Space by aman179102 AI models are terrible at betting on soccer—especially xAI Grok GitHub - xialeistudio/echoic GitHub - HimashaHerath/github-dev-wrapped: AI-powered weekly GitHub activity reports deployed to GitHub Pages GitHub - alejandrobalderas/claude-code-from-source: Architecture, patterns & internals of Anthropic's AI coding agent — reverse-engineered from source maps AI and Tech brief: Ireland ascendant GitHub - Titovilal/context0: Context0 - Never Surrender Training for a Marathon with an AI Coach: What Worked and What Didn't Cyber Pulse: Agentic Intel - Apps on Google Play I Built an AI PR Reviewer That Catches Bugs by Not Looking for Bugs Gen Z workers are so fearful AI will take their job they’re intentionally sabotaging their company’s AI rollout | Fortune How AI Is Reimagining the Game of Golf–For Both Players and Courses GitHub - nattergabriel/reseed: A CLI tool for managing and distributing agent skills across projects Is SVG the final frontier? My AI workflow evolved from prompts to a near-autonomous workflow MLSharp Help - 3DGS Viewer & Generator I put my cognitive field based AI's runtime on GitHub Is Numble the first AI-proof game? A3: Kubernetes for autonomous AI agent fleets | Emergent Principles Deepali Vyas ("The Elite Recruiter") GitHub - msmarkgu/RelayFreeLLM: A restful API designed to route user prompts to various AI model providers. Unionized ProPublica staff are on strike over AI, layoffs, and wages Unleashing the Advantage of Quantum AI We're heading for an AI-fueled 'dementia crisis,' brain scientist warns The AI-Assisted Breach of Mexico's Government Infrastructure [pdf] GitHub - stef41/lmscan: 🔍 Detect AI-generated text and fingerprint which LLM wrote it. Open-source GPTZero alternative. Zero dependencies, works offline. MSN GitHub - visionscaper/collabmem: Enabling long-term collaboration with Agentic AI - building up episodic and world model memory over time with in-context awareness We gave an AI a 3 year retail lease in SF and asked it to make a profit | Andon Labs AI Code is Hollowing Out Open Source, and Maintainers are Looking the Other Way What leaked "SteamGPT" files could mean for the PC gaming platform's use of AI AI is the boss at this retail store. What could go wrong? GitHub - Wuzu11517/agentic-proxy: Local proxy meant to help reduce With Drones, Geophysics and ArtificiaI Intelligence, Researchers Prepare to Do Battle Against Land Mines A Single Operator, Two AI Platforms, Nine Government Agencies: The Full Technical Report 在 Steam 上购买 FriedrichAI: Offline AI 立省 10% GitHub - inevolin/resume-cli: Hit Claude usage limits? Resume any AI coding session elsewhere. Switch tools at zero friction. GitHub - atripati/ark: AI Runtime Kernel — a context operating system for AI agents. Eliminates tool bloat, loads only what’s needed, and gives LLMs their reasoning space back. How to Build a Secure AI PR Reviewer with Claude, GitHub Actions, and JavaScript This Startup Wants You to Pay Up to Talk With AI Versions of Human Experts Intel Arc Pro B70 Brings 32GB VRAM to Local AI for $949 WordPress 7.0: The Good, the AI, and the Still Missing AI on the couch: Anthropic gives Claude 20 hours of psychiatry IatroBench: Pre-Registered Evidence of Iatrogenic Harm from AI Safety Measures AI Agents Know About Supabase. They Don't Always Use It Right. The history and future of AI at Google, with Sundar Pichai Inside an AI‑enabled device code phishing campaign How Meta Used AI to Map Tribal Knowledge in Large-Scale Data Pipelines AI for Systems: Using LLMs to Optimize Database Query Execution Forecasting the Economic Effects of AI Introducing Tinker: Play with AI, bring your ideas to life AI sheds light on an ancient gaming mystery People really hate AI but not as much as Iran—or Democrats | Fortune What is an AI Product Engineer? Phoebe Gates wants her $185 million AI startup to succeed with 'no ties to my privilege or my last name': 'I have a chip on my shoulder' | Fortune
How to build an AI helper for your team with Cowork
adamfaik · 2026-05-19 · via Hacker News - Newest: "AI"

A colleague pinged me on Slack last month. ”We don’t have an AI playbook.” I had heard the same question from four other people that week. Everyone at the company is trying out AI tools right now. They want to know what’s allowed and what isn’t. And nobody wants to be the one who pastes customer data into the wrong tool.

I said yes, let me build one. Three weeks later, I had three Claude Code skills running. One drafted AI cards from real team questions. One reviewed every card. One shipped the approved cards to Confluence. I felt proud of what I had built. I was already planning the next skill, the one that would check every card each month for stale answers.

Then I sat down and did the math. How many cards would I need to answer every AI question anyone might ask? Roughly 10 approved AI tools. About 10 common questions for each tool. About 10 less-common questions for each. That comes to one thousand cards. Cards I would have to update every time a vendor changed a page or legal added a rule. My industrial engineering professors taught us one rule above all others: never produce stock you don’t have an order for. I had spent three weeks producing stock. So I stopped.

The second time, I was chasing the same outcome. Answers about AI tools, grounded in our company’s rules, available to anyone who asks. The first build would have taken me months. The second took one focused afternoon in Cowork. Same use case. Two very different ways to apply AI. AI doesn’t make you faster on its own. The direction you pick with AI does.

There are three acts to this. Each one builds on the last. I’ll walk you through all three.

A three-panel infographic previewing the article’s structure. Panel 1 (”The story”): an overflowing stack of Confluence cards on one side, a single tidy context page paired with a skill icon on the other, with an arrow showing the shift from stock to flow. Panel 2 (”The build”): a horizontal sequence of small numbered steps representing scaffold, fill the page, install, test, iterate, ship. Panel 3 (”The pattern”): a single skill icon at the top with multiple labeled context pages branching off underneath — AI rules, OKRs, brand voice, feedback.
Three acts: the story, the build, the pattern.
  • The story. Why every AI playbook ends up unused. The instinct to build one is universal, but the math breaks every time. I’ll show you the shape that worked for me instead.

  • The build. Walk through the build with me in Cowork. The whole thing takes one focused afternoon, end to end. By the time you finish reading, your skill is shipped and ready for your team.

  • The pattern. The AI helper is one example of a reusable shape. Swap the context page and you have a different helper. OKRs, feedback, brand voice, onboarding: all from the same skill scaffold.

By the end, you will have built an AI helper your team uses. Teammates ask it first, before they DM you. The routine questions get answered without you. The complex ones still come to you, but only after the helper has handled what it can. The example I walk through is the one I built: an AI helper for ”can I use this AI tool, and how?” questions in our specific context. The same shape works for any routine team question that depends on context, like OKRs, feedback, brand voice, or onboarding. I’m sharing the GitHub repo too, so you can clone it and start from a working example: github.com/adamfaik/ai-ask.

One prerequisite to follow along. You need Claude Cowork, which is the agentic surface in the Claude desktop app. It comes with any paid Claude plan: Pro, Team, Max, or Enterprise. The build won’t work in plain chat mode.

Let’s jump into it!

The playbook instinct feels right at first. Cards are the right unit. Each card answers one question. Each card lives in Confluence where everyone can find it. I just had to write the cards. That’s where Claude Code skills came in. Why write a thousand cards by hand when I could build a small factory to produce them?

So I built three skills, each with a clear job. Each skill produced a clear output for the next one in line. The whole thing was a small assembly line for documentation cards. Together they would keep the documentation always fresh, always on-brand, always in the right place.

A horizontal flow diagram. A team question enters on the left as a speech bubble (”Can I use Cursor on my Mac?”). It flows through three labeled skill boxes left-to-right: Drafter (researches the answer and writes the first draft), Reviewer (runs the card against a quality checklist, with a small dashed arrow looping back to the Drafter for cards that fail), Shipper (formats the card, picks the right labels and parent page, publishes). The output is a finished Confluence card on the right with a “Published” stamp, sitting in a stack labeled “Confluence”.
Three skills, one assembly line.

The first skill was the drafter. I would paste a real team question into it, like ”Can I use Cursor on my Mac?” The drafter would research the answer. It would search the web for the vendor docs, the official install steps, recent policy updates. Then it would produce a draft card with a consistent structure: a clear title, the answer, the contact for follow-up, links to the official documentation. The output was a complete first draft, ready for review.

The second skill was the reviewer. It took the drafter’s output and ran it against a quality checklist. Is the answer specific? Is the contact named? Is the link still live? Are there any AI-policy red flags? If the checklist passed, the card moved on. If it failed, the reviewer suggested fixes and sent the card back to me. The reviewer was the gatekeeper that kept the factory from shipping bad cards.

The third skill was the shipper. It took an approved card and prepared it for publication. It formatted the markdown for Confluence. It generated the right labels by tool, by topic, by audience. It picked the right parent page in our information architecture. Then it published. The shipper turned a clean draft into a live page my teammates could actually find.

I was proud of the architecture. The three skills handed cards to each other in a clean line. Real questions came in on one side. Polished, labeled, published cards came out the other. I was already planning the fourth skill, the one that would crawl every card each month and flag the ones that had gone stale. The factory would run itself.

Then I sat down and did the math. How many cards would I need to answer every AI question the company might ask? About 10 approved tools. About 10 common questions for each tool. About 10 less-common questions for each. That comes to one thousand cards. A thousand cards I would have to update every time a vendor changed a page or legal added a rule.

My industrial engineering professors taught us one rule above all others. Never produce stock you don’t have an order for. Toyota built an empire on this idea. Don’t make the part until someone needs it. The factory I was building would produce stock the team would never visit. So I stopped.

What did I actually need? An LLM already knows a lot. It has read the Internet many times during training. It can search the web for recent information. For most questions, it can already give a reasonable answer on its own.

If a teammate asks ”how do I install Cursor on my Mac?”, a fresh Claude chat can tell them. It will give the standard install steps from cursor.com. The answer will be correct. But the answer will be generic. It will not know that at my company, Cursor requires SSO. It will not know about the Confluence MCP integration. It will not know that autocomplete is disabled on certain file paths.

The missing piece was a layer of context specific to the company. What’s allowed and what isn’t. Who to contact when something is unclear. What gotchas surprise new joiners. The playbook was trying to be that layer, but it tried to do it as a stack of cards. I needed something different.

So I built one skill instead. I called it /ai-ask. The skill reads one document on every invocation. That document holds the company-specific layer of context. One source of truth. Every question pulls from it. Every answer comes out grounded in our reality.

A teammate’s free-form AI question on the left flows into a Claude skill labeled “ai-ask” in the middle, which reads from a single document labeled “company context”. On the right, the skill returns a two-part structured answer: “Company context” followed by “General guidance”.
One skill, one company-context page, every team question grounded.

And that’s when it clicked. I now see this skill as a prism, like the one on the cover of Pink Floyd’s Dark Side of the Moon. Picture it. White light enters one side. The prism refracts it. A rainbow comes out the other.

In our case, the white light is what the LLM already knows. The Internet, vaguely remembered from training, plus what the model can pull from a web search. The prism is the company-context page. The rainbow is the answer: what the LLM knows in general, refracted through what is true at my company in particular.

This is the same logic as just-in-time manufacturing. Don’t produce stock you don’t have an order for. Produce the answer when someone asks the question. The context page is the only thing you maintain. Every answer regenerates from it. You don’t keep a stack of stale cards.

The skill re-reads the context page on every invocation. That’s not a side effect. It’s the whole design. Memory from earlier in the conversation can be stale. The page may have been updated. Stale answers about policy are worse than no answer at all.

So what does this look like in practice? Teammates type /ai-ask followed by their question instead of DM’ing you. The questions are the kind you have already answered a hundred times: ”Can I use ChatGPT free for this customer feedback?”, ”Is Cursor approved on my Mac?”, ”What model should I use for code review?” The skill answers all of them in the same shape: company context first, general guidance second.

The answer they get is grounded in your team’s rules. The right contact is named. A link to the official documentation is at the end. They get a real answer, fast, without waiting on you. What does this deliver for you? Your DMs go down. The team self-serves answers grounded in your rules. You get your focus back.

I built mine for AI questions because that’s the routine question I kept getting. You can see the live code in the public repo at github.com/adamfaik/ai-ask. But the same pattern works for any routine team question that depends on company-specific context. Swap the context page for a different document, and you have a different team helper.

OKR alignment (does this initiative line up with our quarterly goals?). Feedback reviews (is this the way our team gives feedback?). Brand voice checking (is this on-brand for us?). New-joiner onboarding (who do I ask about X?). You’re learning a pattern, not just an AI Q&A bot.

Open Cowork.

One focused afternoon, end-to-end. Here are the seven steps you’ll go through. Glance at the map before we dive in.

A horizontal flow of seven numbered boxes labeled Step 1 “Start the skill”, Step 2 “Read what was created”, Step 3 “Write the company context”, Step 4 “Save the .skill file”, Step 5 “Test in Chat mode”, Step 6 “Iterate by chat”, Step 7 “Ship to your team”. An arrow connects each box to the next. A small note at the bottom indicates that Step 5 happens in Chat mode while the others happen in Cowork.
Seven steps. One afternoon. Step 5 happens in Chat; the rest happen in Cowork.

Before Step 1, a quick setup. Download the Claude desktop app from claude.com/download if you don’t have it yet. Sign in with your paid Claude account. Confirm you see three tabs at the top: Chat, Cowork, and Code. We will spend most of our time in Cowork. Cowork is the agentic surface that can read and write files, run skills, and operate on a folder. The last step uses Chat to test the finished skill.

Three things to keep in mind as you go. The prism page is where the real work lives. Scaffolding is fast. Every meaningful step is one prompt to Cowork, not manual file editing.

Open Cowork. Below the chat input, click Work in a project → Choose a folder. The native folder picker opens. Navigate to wherever you keep code projects. Mine is ~/Documents/GitHub/. Click New Folder, name it ai-ask, and select it. One folder, three jobs: source of truth for editing, install target for Cowork, repo root for the GitHub push later.

The Cowork home screen with the “Work in a project” dropdown open, showing two options: “Create new project” and “Choose a folder”.
Pick a folder; Cowork operates from there.

Now use Anthropic’s skill-creator to scaffold the skill. Don’t write the SKILL.md file by hand. skill-creator interviews you about the skill you want and generates the file structure for you. Type /skill-cr in the chat input and skill-creator should appear in the autocomplete dropdown. If it isn’t there, install it from Customize → Skills → + → Browse skills → search “skill-creator” → Install.

The Cowork chat input showing the autocomplete dropdown with “skill-creator” highlighted, including its description about creating new skills.
skill-creator is the scaffolder.

One detail matters before you send the prompt. Switch the model to Opus 4.7 in the chat input bar. Cowork’s model picker is session-locked. The choice you make now applies to the whole conversation. Invest the smart model on the work that defines a system once. Use the efficient model on the daily work that runs that system every day. Building a skill is the first kind. Using it every Monday is the second.

Invoke /skill-creator and either paste or dictate this paragraph as the opening brief. I usually open SuperWhisper and just talk the prompt out loud, as if I were explaining what I need to a teammate, a friend, or an intern I’m asking for help. Either way, the content is the same:

/skill-creator I want to build a skill called ai-ask. Its purpose is to answer any AI-related question from someone on my team by combining general AI knowledge with my company’s specific rules and context. The skill should trigger whenever the user asks about AI tools, models, prompts, data handling, licensing, or AI-related workflows. Examples of phrasings to trigger on: ”can I use X?”, ”how do I install Y?”, ”is Z allowed?”, ”what’s the best model for...?”. It takes a free-form question as input. It should always answer in two parts: first the company-specific context (allowed or forbidden tools, data-handling rules, contacts, escalation paths) drawn from a bundled file called company-context.md; second, the general AI guidance (how-to steps, prompt patterns, official documentation links).

The Cowork chat input shows the long opening prompt pasted in, with the ai-ask project active and Opus 4.7 selected as the model in the input bar.
One paragraph in, the whole skill spec out.

skill-creator reads the brief and asks a few clarifying questions. Your exact questions might be slightly different from mine. Each session is a little unpredictable, that’s just how LLMs work. The principle is the same: it fills in the gaps before it starts writing files.

The first asks what should go in company-context.md. Pick ”I’ll provide content myself.” You’ll fill the page in the next step. Letting skill-creator interview you for the content here would slow things down for no reason.

The skill-creator QCM showing question 1 of 3, “What should I put in company-context.md?”, with options for a template with placeholders, having Claude ask questions to fill it in, or providing content yourself.
Q1: pick “I’ll provide content myself.”

The second asks how rigorous evaluation should be. Pick ”Quick draft only.” We don’t need to test this skill in an industrialized way. We will just try a few real questions on it ourselves in the next step. A quick draft is enough for that.

The skill-creator QCM showing question 2 of 3, “How rigorous should evaluation be?”, with options for a full eval loop (recommended) or quick draft only.
Q2: pick “Quick draft only.”

The third asks where the final skill should live. Pick ”Both.” You need both formats for two different jobs. The folder is what makes editing and git init-ing work. The .skill package is what Cowork installs in Step 4. Without the package, you cannot install the skill the right way.

The skill-creator QCM showing question 3 of 3, “Where should the final skill live?”, with options for the ai-ask folder, packaged as .skill file, or both.
Q3: pick “Both.” This matters more than it looks.

After the third answer, skill-creator lays out its plan and starts writing files. The completion summary at the end is worth reading. It surfaces design choices the skill author would otherwise miss: the ”Read it fresh every time” anti-staleness rule, the ”Don’t invent rules” guardrail, the two-part answer format with exact headings. Once it finishes, the project folder holds SKILL.md and an empty company-context.md.

Cowork shows the completion summary from skill-creator, describing what was built including the two-part answer format in SKILL.md and the placeholder structure in company-context.md, with both files visible in the project pane.
Skill is ready. Here’s what got built.

The scaffold is done. Now we read what Cowork actually made.

Before going further, take a minute to read what skill-creator actually generated. Open SKILL.md in your text editor or in Cowork’s preview pane. Make sure the skill matches what you asked for.

This file is what Claude reads every time someone calls /ai-ask. It has YAML frontmatter at the top (name and description), then a body that defines: when the skill should trigger, what input it takes, what shape the answer must follow, and the rule that it must always read company-context.md first.

If something is missing or off, ask skill-creator in the same chat to update it. The skill is just text. You can iterate. Don’t move on until you trust the SKILL.md.

For reference, you can see the version I ended up with on GitHub: github.com/adamfaik/ai-ask/blob/main/SKILL.md. Your version will look similar but tuned to your own brief.

With the skill itself in shape, we move to the most important step: writing the company context.

This is the most important step. Once you define your company’s rules clearly, the skill will work or not based on what’s in this page. The page IS the prism. Take your time here.

skill-creator already wrote a 7-section template in company-context.md with [FILL IN] placeholders. Open the file in Cowork’s preview pane to see it. The template has seven sections: approved tools, forbidden tools, data handling, licensing, approval paths, preferred providers, open questions. The scaffolding is there. The content is yours.

Split view showing skill-creator’s hand-off message on the left explaining the [FILL IN] placeholders, and the rendered company-context.md template on the right with empty sections for Approved AI tools and Forbidden tools, both populated with placeholder bullets.
The “before” state: structure in place, content empty.

You can fill this page however you like. You could have a back-and-forth discussion with Cowork, building the page one section at a time. You could draft it yourself in your text editor and paste it in. You could send one structural prompt and let Cowork generate the whole thing at once. There is no one right way. The page is yours, and the process should match how you think.

For this article, I happened to do it in one prompt. That worked because I had already thought through what each section needed. Your first version will probably take longer because you are figuring out the rules as you write them. That is the point of this step. Expect to spend real time here.

Here is the prompt I used, as an example of what one approach looks like. The prompt uses a fictional company called Acme because my real company’s content is private. At your real company, swap the proper nouns. The structure stays the same.

Update this company-context.md file in two passes.

Pass 1. Fill every [FILL IN] placeholder with content for a fictional company called Acme: a 300-person B2B SaaS for product teams, mid-AI-adoption, with SSO, IT, and legal review in place. Use clearly-fictional proper nouns: AI Champions Sarah K (Product) and Jordan L (Engineering); Legal contact Maya P at legal-ai@acme; IT at support-it@acme; vendor risk at vendor-risk@acme; internal access portal at access.acme/forms/ai-tools; Slack channels #ai-help, #ai-discussion, #ai-tools-feedback. Approved tools include Claude (Pro, Team, Max, Enterprise), Cursor with Acme SSO, GitHub Copilot for Engineering, NotebookLM, Perplexity. Split Data handling rules into four tiers (Public, Internal, Customer data, Regulated).

Pass 2. Add three new sections: Approved use cases by function, Sharing rules, and Acme-specific gotchas.

Keep the existing intro blockquote. Plain prose.

Cowork executes both passes in one turn. It verifies the output: both files at the project root, byte counts match, the intro blockquote is preserved, all section headings are in place. What comes out is a ten-section company context page ready to be tested.

The Cowork chat shows the enhancement prompt sent and the confirmation that both passes ran successfully, with the rendered company-context.md visible on the right side displaying the Approved AI tools and models section with concrete Acme content about Claude plans, Cursor with SSO, GitHub Copilot for Engineering, NotebookLM, and Perplexity.
One prompt, ten sections, full prism page.

For reference, you can see the full version on GitHub: github.com/adamfaik/ai-ask/blob/main/company-context.md. It will give you a sense of what your version could look like once it’s filled in.

The prism page is human-editable markdown. Your team can update it without touching the skill code. Store the prompt, not the result. The result regenerates every time the page changes.

Now install it. There’s a trap.

Cowork’s Save Skill button can install your skill in two different formats. The format you pick matters more than it looks.

  • If you save the skill as a .md file, only SKILL.md gets installed in your Personal Skills. Your company-context.md, the prism, stays on disk in the project folder. The skill is now installed, but without the file it is instructed to read on every invocation. The skill is there. The prism is not.

  • If you save it as a .skill file, both SKILL.md and company-context.md get bundled together and installed as a unit. The skill has its prism wherever it goes. This is the format you want.

Side-by-side diagram. Left: a lone SKILL.md flying into Claude on its own, with the company-context.md left behind on the desk; the answer below approves ChatGPT generically. Right: SKILL.md and company-context.md wrapped together in a single .skill bundle; the answer below refuses with the Tier 3 customer-data rule.
Ship the prism with the skill.

To get a .skill file, ask Cowork to package the skill before you click Save. A .skill file is a zip bundle with both files at the root. Paste this in the same chat:

Please package the ai-ask skill as a .skill file. It should bundle both SKILL.md and company-context.md at the root of the archive (no enclosing subfolder), so I can install it into Cowork through the Save Skill button. Save the .skill file inside the project folder, and confirm the archive contents.

Cowork creates ai-ask.skill and verifies the contents. The format requirements are the same as Cowork’s Upload Skill dialog accepts: a .zip or .skill archive that includes SKILL.md at the root. The format Cowork generates matches the format Claude accepts.

The Customize → Skills → Upload skill dialog showing the file requirements: the .md file must contain skill name and description formatted in YAML, and the .zip or .skill file must include a SKILL.md file.
The format Cowork generates matches the format Claude accepts.
Cowork’s post-packaging verification message stating that the archive contains exactly two entries at the root, SKILL.md (5,755 bytes) and company-context.md (11,157 bytes), with no enclosing subfolder and YAML frontmatter intact, with the ai-ask.skill file visible in the project pane.
Two files at root, frontmatter intact.

Now click Save Skill. With ai-ask.skill as the current artifact in the chat, the Save Skill button installs the full bundle. Open Customize → Skills. ai-ask appears under Personal skills, expanded to show both SKILL.md AND company-context.md nested underneath. The bundle landed. Both files installed. Toggle is on, trigger set to ”Slash command + auto.”

The Customize panel with ai-ask listed under Personal skills, expanded to show SKILL.md and company-context.md nested as files under the skill, with the toggle on, trigger “Slash command + auto”, and the rendered SKILL.md body visible in the right pane.
The bundle landed. Both files installed.

The principle to take with you: if your skill uses bundled context files, make sure you generate a .skill file before clicking Save. A skill without its prism is just a skill.

Now test it.

Three questions cover the spectrum. One that should refuse (gated by company rules). One that needs company context before generic instructions. One that’s generic enough the skill should stay quiet.

Before you test, switch to Chat mode in the Claude desktop app. The /ai-ask skill triggers from the Chat tab, not from Cowork. Cowork is where you build skills. Chat is where you and your team actually use them. Open a fresh Chat conversation and pick Sonnet 4.6 as the model. Sonnet is fine for daily use, per the ROI principle from earlier.

Test 1: refusal.

/ai-ask Can I use ChatGPT free tier to summarize a customer feedback I exported?

The full /ai-ask chat showing the question about ChatGPT free for customer feedback and the refusal answer in two parts: “Company context” leading with the No, then “General guidance” recommending Claude Enterprise as the default and explaining the Claude Projects file-retention gotcha.
The “no, and here’s why, and here’s what to do instead” pattern.

Test 2: company context first.

/ai-ask I want to install Cursor on my Mac. How do I do it?

The /ai-ask chat showing the question about installing Cursor on Mac and the answer with company context (SSO setup, Confluence MCP integration, magic-link gotcha, customer-data autocomplete limitation) leading before the standard Cursor install steps.
Acme process leads. Generic install steps follow.

The ordering is the proof. Acme’s actual process comes first: SSO, the Confluence MCP gotcha, the customer-data autocomplete limitation. The generic Cursor install steps come after as a reference. The teammate who reads this knows what to do AND why the company path matters first. Without the prism, the answer would have led with the generic install steps and skipped the company context entirely.

Test 3: restraint.

/ai-ask How do I write a good prompt for code review?

Restraint: short company context, then heavy generic guidance.

Now sharpen the format.

The tests passed, but the answers were long. They also didn’t link to official docs. Real iteration is structural feedback. Length, ordering, what to include or exclude. Not single-answer tweaking. And it’s a plain-English conversation in the same skill-creator chat: no manual SKILL.md editing, no toggle dance.

Send the feedback as a plain prompt:

The skill works but the answers are too long and there are no links to official docs. Restructure the answer format. Company context: maximum 1-2 sentences. Only the specific rule that applies. Skip the surrounding explanation. Steps: a numbered checklist with one action per line. No paragraphs. Reference docs: at the very end, include a link to the official documentation for the tool or topic the question is about. Search the web for the canonical URL. Update SKILL.md, re-package as .skill, then tell me when it’s ready to re-save.

Cowork updates SKILL.md and re-packages the bundle. The new SKILL.md is 119 bytes shorter than the previous version. Not that the byte count is what matters. The real proof is the re-run.

Cowork’s iteration recap describing the new SKILL.md format including a non-negotiable “shape” with three sections, explicit good-vs-bad examples for the Steps section, and an allow-list (vendor docs, install guides, model cards, pricing pages) and deny-list (blog posts, third-party tutorials, AI-generated summaries) for the Reference docs section.
The recap: shorter context, numbered steps, web-searched reference docs.

When you click Save Skill, Cowork prompts a confirmation: ”There’s an existing skill with the same name. Uploading this skill will replace the existing one, which can’t be restored.” Click Upload and replace. The new bundle takes over for any future invocation.

A confirmation modal titled “Replace ai-ask skill?” with the message about an existing skill being replaced and two buttons: Cancel and Upload and replace.
Confirm the replace; the new bundle takes over.

Now re-run the Cursor-install question. The answer shape is exactly what you asked for. Two-sentence company context. Five-step numbered checklist. Two canonical doc links at the bottom. The header reads ”Viewed 3 files, searched the web ›”: proof that the skill now searches for official URLs on every invocation.

The /ai-ask answer for installing Cursor on Mac after iteration, showing the new structure: a 2-sentence Company context section, a 5-item numbered Steps checklist (download installer, drag to Applications, launch and sign in with SSO, verify Confluence MCP, flag AI-assisted commits), and a Reference docs section at the bottom with two links to Cursor’s official documentation.
One prompt of feedback. Every future answer reshapes.

This is the moment that pays off the whole build. One short prompt of feedback. Every future answer reshapes. Tune the lens once, every answer benefits.

This is also where the real time goes on a build like this. Scaffolding a skill takes one focused session. Getting the answer format your team will actually use takes several rounds of iteration across several conversations. Plan the calendar around iteration, not scaffolding. In practice, one to three hours of feedback rounds.

Now share it.

Two distribution paths, different jobs. Pick both. Each one solves a different problem. Let me show you why.

Inside Claude, shared skills are view-only on the recipient side. Your teammates can enable, disable, and use the skill. But they can’t edit SKILL.md or company-context.md. That single constraint is why the right answer is two paths. One for fast install. One for collaborative iteration. Solve the constraint, don’t fight it.

Path A: Org install via Claude. If you’re on Team or Enterprise, the official path is Organization settings → Skills → Share with organization. The toggle is off by default. Once on, click Share on your skill in Customize. The skill appears in your org’s directory. Teammates install with one click. The fastest way to put a working skill in 50 teammates’ hands.

Two prerequisites worth flagging for your IT conversation. The admin needs to enable Code execution + File creation at Organization settings → Capabilities before the Skills toggle takes effect. And org-wide sharing has no approval workflow. Once enabled, any member can publish a skill to the directory without review. Useful intelligence to bring to that conversation.

Path B: Public GitHub. One prompt to Cowork handles the whole publish. Cowork uses gh repo create to make the public repo, writes a README with a fictional-Acme disclaimer, commits, and pushes. The live repo is at github.com/adamfaik/ai-ask. You can clone it, swap in your context, and start from there.

The AI helper is one use case. Here’s what else this pattern handles.

Everything you just built is a pattern, not just an AI helper. One skill. One context page. A structured two-part answer. Anywhere your team asks the same routine question that depends on your specific context, the prism applies. The article’s example is AI Q&A. The pattern handles much more.

A single Claude skill at the center of the diagram, surrounded by four context pages labeled “AI rules”, “Quarterly OKRs”, “Brand voice”, “Feedback rubric”. Below the skill, four matching answer bubbles in the same two-part format. The caption inside the diagram reads “Same skill. Different lens. Build one, run a hundred.”
Same skill. Different lens. Build one, run a hundred.

Here are four use cases where the same shape earns its keep. Each one swaps the context page for a different document. The skill scaffold stays the same. Build the skill once, point it at four different pages, ship four different helpers.

  • OKR alignment helper.

    • Audience: PMs drafting features.

    • User request: ”Does this initiative line up with our quarterly OKRs, and which one?”

    • What comes back: ”Closest match: OKR-Q2-3 ‘increase activation by 15%’ (alignment 0.6). Two stronger fits to consider before locking: OKR-Q2-1 (north-star activation rate) and OKR-Q2-7 (week-one retention).”

    • Context page: the team’s current-quarter OKR doc.

  • Feedback reviewer.

    • Audience: anyone shipping a draft.

    • User request: ”Is this feedback the way our team gives feedback?”

    • What comes back: ”Reads well overall. Two SBI-format gaps: paragraph 2 names the situation but not the behavior; paragraph 4 gives behavior but no impact. Add one sentence each.”

    • Context page: the team’s feedback rubric (SBI, Radical Candor, or whatever you standardized on).

  • Brand voice checker.

    • Audience: marketing, sales, or support drafting external copy.

    • User request: ”Is this on-brand for us?”

    • What comes back: ”Three off-tone moments. Paragraph 1 uses ‘revolutionary,’ which the brand guide bans as hype. Paragraph 3 leads with what we did rather than what the customer gets. The CTA is passive; our voice is action-first. Suggested swaps listed inline.”

    • Context page: the brand voice guide.

  • Onboarding concierge.

    • Audience: new joiners in week one (and anyone three months in who still doesn’t know who to ask).

    • User request: ”Who do I ask about X at this company?”

    • What comes back: ”For laptop and SSO issues, support-it@. For new-tool requests, vendor-risk@. For OKR questions, Sarah K in Product. Fastest path: #ai-help in Slack, answered within a day.”

    • Context page: an org-chart-style page mapping topics to contacts and channels.

Here is the principle. The skill is the lens. The context page is what you’re looking through it at. Swap the context page, get a different team helper from the same skill scaffold. Build one prism. Run a hundred queries through it.

If you’ve been holding the “we need an AI playbook” assignment from your manager, you don’t need a 1,000-card Confluence space. You need one skill, one context page, and an afternoon in Cowork. The team gets answers grounded in your rules without DM’ing you. You get your focus back. And the same pattern adapts to OKRs, feedback, brand voice, anything routine that depends on context.

Here is where to start. Pick the routine question your team asks you most often. Write a one-page context document for it. Open Cowork. Run skill-creator. Answer the QCM. The scaffolding takes one focused session. Then send one enhancement prompt to fill the page. Package as .skill. Click Save Skill. Test against three real questions from your inbox. Iterate by chat until the answer shape is what your team will actually use. Ship to your team via the org install or GitHub. You’ll have a working helper the same week you read this.

If you want a head start, clone the repo at github.com/adamfaik/ai-ask. Fork it. Replace the Acme content with your context. And tell me what you built.

No posts