Microsoft
Install Directline Chat
Pick your agent. Every command is ready to paste.
npx skills add microsoft/skills-for-copilot-studio --skill directline-chatThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads directline-chat when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the directline-chat skill”. In Codex, type $directline-chat.
DirectLine Chat (Deprecated)
This skill has been merged into /copilot-studio:chat-with-agent, which now auto-detects the agent's authentication mode and uses DirectLine automatically for no-auth and manual-auth agents.
Use /copilot-studio:chat-with-agent instead. It handles both DirectLine and Copilot Studio SDK modes in a single skill.
If you are here because the caller explicitly provided a DirectLine secret or token endpoint URL, you may proceed with the instructions below. Otherwise, redirect to /copilot-studio:chat-with-agent.
Direct Usage (when caller provides explicit DirectLine credentials)
Token endpoint mode
node ${CLAUDE_SKILL_DIR}/../../scripts/directline-chat.bundle.js \
--token-endpoint "<url>" "<utterance>"
DirectLine secret mode
node ${CLAUDE_SKILL_DIR}/../../scripts/directline-chat.bundle.js \
--directline-secret "<secret>" "<utterance>"
Multi-turn
node ${CLAUDE_SKILL_DIR}/../../scripts/directline-chat.bundle.js \
--token-endpoint "<url>" "<follow-up>" \
--conversation-id <id> --directline-token "<token>"
Always pass --directline-token when resuming. DirectLine tokens are bound to the conversation. They expire after ~30 min.
Output format
Same as /copilot-studio:chat-with-agent Phase 1a — see that skill for full documentation of JSON output, sign-in flow, and error handling.
Tips for Directline Chat
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Directline Chat
What does the Directline Chat skill do?
DEPRECATED: Use /copilot-studio:chat-with-agent instead — it auto-detects DirectLine vs M365 mode. This skill is kept for backwards compatibility only.
How do I install Directline Chat?
Run "npx skills add microsoft/skills-for-copilot-studio --skill directline-chat" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Directline Chat work in Cursor and Codex?
Yes. Directline Chat uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Directline Chat free?
Directline Chat is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made Directline Chat?
Directline Chat is published by Microsoft in the microsoft/skills-for-copilot-studio repository, together with 29 other skills.
