One read of Claude Documentationclaude-docs-20261002T190705Z
4 pages moved out of 259 read.
Pages moved
4
significant first
Pages read
259
in this capture
Captured
19:07 UTC
Corpus hash
d4c4b6e7f64f
corpus-hash
What this read moved
1-4 of 4claude-tag/users/troubleshooting Changed · +19 / -0 lines
### Agents can only be added at the start of direct messages
from line 701
701701
702702Start a private channel with the same members instead.
703703
704### Agents can only be added at the start of direct messages
705
706**What you see**
707
708You mention `@Claude` in a DM you already have with someone else. Slack shows this notice, and Claude doesn't reply:
709
710> Agents can only be added at the start of direct messages.
711
712**What it means**
713
714Slack adds an agent such as Claude to a DM only when the DM is created, so your mention never reaches Claude. The rule is Slack's rather than a Claude setting, so your Claude admin can't change it.
715
716**How to resolve**
717
718Choose where to continue with Claude:
719
720* **In a private channel with the same people**: Slack's notice offers to move this conversation to a private channel that includes Claude. Take that option, then mention `@Claude` in the new channel. If Claude doesn't answer there, or answers with a setup notice, see [Mentioning @Claude does nothing at all](#mentioning-@claude-does-nothing-at-all).
721* **In a one-to-one DM**: message Claude directly.
722
704723## Related resources
705724
706725* [Control when Claude Tag responds](/docs/claude-tag/users/when-claude-responds): what makes Claude reply without an @-mention, and the controls that turn those replies off
plugins/overview Changed · +9 / -1 lines
from line 20
2020
2121### Before you add a plugin
2222
23A plugin's skills and commands are instructions Claude follows, and its connectors reach outside services with the account you connect. In Cowork and Claude Code a plugin can also run agents and hooks, which run commands on your computer when certain events happen, and a connector marked **Runs in each session** runs a program on your computer. Anthropic reviews plugins listed in the directory: every version gets automated validation and a security scan, and a person reviews a new listing before it goes live, as [Prepare for review](/docs/directory/publish#prepare-for-review) describes. That review doesn't cover a plugin you add from a marketplace URL or upload yourself, so add those only from sources you trust. On Team and Enterprise plans, an Owner controls which sources members see and whether they can add their own, as [Manage plugins for your organization](/docs/plugins/admin) covers.
23A plugin's skills and commands are instructions Claude follows, and its connectors reach outside services with the account you connect. In Cowork and Claude Code, some parts of a plugin also run on your computer:
24
25* **Agents and hooks**: run commands on your computer when certain events happen
26* **A connector marked Runs in each session**: runs a program on your computer
27* **A mod**, in Claude Code only: code that runs inside Claude Code and can change what it does and shows. See [Decide whether to trust a mod](https://code.claude.com/docs/en/plugins/mods/overview#decide-whether-to-trust-a-mod)
28
29Anthropic reviews plugins listed in the directory: every version gets automated validation and a security scan, and a person reviews a new listing before it goes live, as [Prepare for review](/docs/directory/publish#prepare-for-review) describes. That review doesn't cover a plugin you add from a marketplace URL or upload yourself, so add those only from sources you trust.
30
31On Team and Enterprise plans, an Owner controls which sources members see and whether they can add their own, as [Manage plugins for your organization](/docs/plugins/admin) covers.
2432
2533### Find and add a plugin
2634
plugins/platform-support Changed · +1 / -1 lines
from line 35
3535| Executables in a top-level `bin/` directory | Can't be installed | Can't be installed | Loads | |
3636| LSP servers, output styles, themes, `settings` | Ignored | Ignored | Loads | [Plugin components](https://code.claude.com/docs/en/plugins/components) |
3737
38When you submit a plugin to the directory, the portal derives the surfaces it supports from these same rules and shows them to you before you submit.
38When you submit a plugin to the directory, the portal derives the surfaces it supports from these same rules and shows them to you before you submit. The directory lists a [mod](https://code.claude.com/docs/en/plugins/mods/overview), which is code a plugin names under `modules` in `hooks/hooks.json`, for Claude Code.
3939
4040## Compare installation, sync, and admin controls
4141
plugins/pre-submission-checklist Changed · +1 / -1 lines
from line 161
161161
162162| What to do | [Result if you don't](#read-a-validation-result) | Title in the report, if it has one |
163163| - | - | - |
164| Make `hooks/hooks.json` valid JSON with a top-level `hooks` object, only the hook events and hook types in the [hooks reference](https://code.claude.com/docs/en/hooks), and an `https://` URL on each HTTP hook | Blocks | **hooks.json is invalid** for invalid JSON |
164| Make `hooks/hooks.json` valid JSON with a top-level `hooks` object, a `modules` array for a [mod](https://code.claude.com/docs/en/plugins/mods/overview), or both. In `hooks`, use only the hook events and hook types in the [hooks reference](https://code.claude.com/docs/en/hooks), and an `https://` URL on each HTTP hook | Blocks | **hooks.json is invalid** for invalid JSON |
165165| Leave `hooks/hooks.json` out of the `hooks` field in `plugin.json`, because Claude Code loads that file automatically | Warning | |
166166| Write valid YAML front matter in each skill, command, and agent file, with `description` as a single text value, not a list | Blocks for front matter that doesn't parse or a `description` that isn't text. Warning for no front matter or no `description`. | |
167167| Name component folders and files with the exact spelling and capitalization Claude Code expects, such as `hooks/`, `skills/`, and `SKILL.md` | Blocks | |