skill-creator
暂无简介
- License 许可
- CC0-1.0
- 最近更新
- 2026-11-14
- Stars
- ★ 0
- Forks
- 0
02 资源文件 5
- 参考文档references/amendments.md2.0 KB
- 参考文档references/mcp-cli.md3.5 KB
- 参考文档skill.yaml356 B
- 参考文档templates/connector/CONNECTOR.md6.2 KB
- 参考文档templates/connector/connector.yaml1.1 KB
03 SKILL.md 正文
Custom Connectors and MCPs
Look for an existing route
-
Search with
muse.connector_searchfor a system or custom connector that already covers the service or the action, and read its docs. -
Check whether Zapier or Composio already reaches the app through the user's account there. One hub connection can cover many apps.
-
Find the provider's official API reference and authentication guide, and look for an official MCP server in its developer docs or GitHub organization. Use
browser.searchto find the pages andbrowser.opento read them. -
Prefer the provider's maintained client or a reputable open-source integration to writing your own. Check its source, permissions, dependencies and recent releases, then pin the version and keep it under
~/workspace/custom-connectors/custom.<provider>/. Installing a package grants it no credentials or permissions.
Connect the credential
-
Call
credentials.request_api_accessinstead of asking for a key, client ID, secret or token in chat. Take its inputs from the provider's docs, not memory. It needs theproviderslug, the bareapi_hosts, theauth_scheme, and either theplacementof an API key or the OAuth authorize and token endpoints. -
Report the scheme the docs describe. Muse supports API keys and the OAuth 2.0 authorization code flow, and declines a password login, session cookie, signed request or multi-secret scheme with a reason to pass on. Choose
api_keywhen the provider offers both. -
Get the hosts, scheme and placement right the first time. A call to an unlisted host is refused, and the scheme and placement cannot change after setup, so a mistake means a fresh link and the user entering the key again.
-
For OAuth, request the least scope the task needs. Supply
registration_urlwhen the provider supports dynamic client registration, so the user does not have to register an app. -
For an OAuth-protected MCP server, always supply
resource: its canonical HTTPS resource URI from its OAuth protected-resource metadata or official docs. Preserve the full URI, including its path and trailing slash if present. The resource identifies the MCP server and may be on a different domain from the OAuth issuer. Save it with the connection details for reconnects. -
Every OAuth endpoint must sit on the provider's
issuer_domainor a subdomain of it. When a provider's endpoints span domains, explain that it cannot be connected this way instead of inventing a workaround. -
Follow the
guidancethe tool returns. It says how to present the link, then you end the reply. The conversation resumes on its own when the user finishes the hosted page. -
A service that only offers a website sign-in is a browser task, not a custom connector.
Build the helper
-
Once connected, run
/opt/muse/skills/custom-connector-setup/bin/scaffold-connector-docs --provider <provider>. It copies the connector template to~/workspace/custom-connectors/custom.<provider>/CONNECTOR.mdwith the slug, scheme and hosts filled in, and creates~/workspace/custom-connectors/custom.<provider>/bin/for helpers. It never replaces an existing doc. -
The credential lives in the registered connection
custom.<provider>, never in a file. Helpers get a surrogate fromdynamic_credentials.py, which places it where the provider reads the key. Muse swaps in the real credential only on an approved request to a registered host.
import json, sys, urllib.request
sys.path.insert(0, "/opt/muse/skills/custom-connector-setup/bin")
from dynamic_credentials import add_surrogate_to_request, read_json_response
class NoRedirect(urllib.request.HTTPRedirectHandler):
def redirect_request(self, *args):
raise RuntimeError("redirect refused, verify the endpoint")
request = urllib.request.Request("https://api.example.com/v1/items")
add_surrogate_to_request(request, "custom.example", allowed_hosts=["api.example.com"])
with urllib.request.build_opener(NoRedirect()).open(request, timeout=30) as response:
print(json.dumps(read_json_response(response)))
-
For a key read from a query parameter or the URL path, build the URL with
url_with_surrogate_query_paramorurl_with_surrogate_path_segmentbefore creating the request. -
Keep keys, tokens, passwords and cookies out of helpers, docs, command arguments, environment variables and logs. Keep redirects disabled on authenticated requests.
-
Compile Python helpers with
python3 -m py_compilebefore saying they work. -
To reach an MCP server, follow MCP-backed CLIs. Start from the MCP client template, which turns the server's operations into
list-toolsandcall-toolcommands.
Verify before saving
-
Nothing checks the credential when the user saves it, so the first real call is the proof. Run a harmless read against the intended account, then the exact operation the user asked for, and check its result.
-
On a 401 or 403, first check that the request carried the credential, that the host is registered and that the placement and scopes match. Call
credentials.request_api_accessagain withreconnect: trueonly when a request that carried the credential is still rejected. Reuse the saved details, adding and saving the canonicalresourcefor an OAuth-protected MCP server when it is missing. -
After an uncertain write, inspect the current state before retrying. The first request may have completed.
Save what you learned
-
Complete the connector doc from its template with the setup details, verified commands, inputs, outputs, pagination and recovery. Label an operation you have not run as untested, and delete the template comments.
-
When the lesson is how to do a task, save it as a skill from the skill template at
~/workspace/custom-skills/<name>/SKILL.md. Improve the closest custom skill instead of adding a duplicate. -
Link the connector doc under the skill's Available connectors and the skill under the connector's Related skills.
-
To correct a system skill or connector doc, write an amendment as amendments explains. Deployments replace system files and keep custom ones.
-
Never store a secret in a connector doc or a skill.
Available connectors
-
Zapier for running actions in apps the user already connected to Zapier.
-
Use
muse.connector_searchto find other connectors andmuse.skill_searchto find related skills.
When available
-
These connectors depend on the user's channel or devices.
muse.connector_searchshows which ones this session has. -
Composio for running actions in apps the user connected to Composio.
Alternatives for better results
-
Compare an existing connector, a hub, an official API, an MCP server and a browser route on capability, access, reliability and cost. Use the simplest route that does the work well.
-
For a one-off task, finish it with
browser.browseon the provider's website or with a file the user supplies. Offer to build a connector when the user will repeat the work.
04 同仓库更多 Skills
model-council
暂无简介
writing-style
Draft or edit writing in the user's voice for the person who will read it and where it will appear. Use for messages, emails, documents or slides written on their behalf, not for your own replies.
write-page
Create or edit requested Page/Space content, or use for prose you have already decided to save as a standalone Markdown file, only if the user did not explicitly request a Markdown file. Honor established formats, destinations, and repository documentation. A selected Page alone does not authorize a write.
software-engineering
For use only in threads for this proactive personal assistant. Investigate software issues; inspect, write, review, or test code; work on a repository or local engineering file; or create, fix, or monitor a pull request or CI run. Use for actual engineering or product QA work, not a general programming explanation.
slides-artifact
Use when the user asks to create, edit, or review slides or a presentation (PowerPoint or Google Slides), including when the task clearly calls for an audience-ready slide deck. Also use to answer questions that require inspecting an existing deck; not for general presentation advice or a chat-only outline.
slack
Use when reading Slack conversations, deciding when to respond, or sending messages, files, and reactions in Slack.