Skip to content

docs: add SAM agent skill#97

Open
AsyncAssassin wants to merge 2 commits into
google:mainfrom
AsyncAssassin:docs/add-sam-skill
Open

docs: add SAM agent skill#97
AsyncAssassin wants to merge 2 commits into
google:mainfrom
AsyncAssassin:docs/add-sam-skill

Conversation

@AsyncAssassin

@AsyncAssassin AsyncAssassin commented Jun 5, 2026

Copy link
Copy Markdown

Summary

  • Add a root-level SKILL.md for agents working with SAM (Sovereign Agent Mesh).
  • Document the local sam-node MCP endpoint and the mesh inspection, service discovery, tool discovery, describe, and call workflow.
  • Include safety guidance for non-loopback endpoints, sensitive data, side-effecting tools, and AWS SAM ambiguity.

Testing

  • Parsed the SKILL.md frontmatter.
  • Ran the documented MCP workflow against a local Docker SAM mesh with a remote calculator MCP service.
  • Include safety guidance for non-loopback endpoints, sensitive data, and side-effecting tools, and explicitly exclude AWS SAM / Serverless Application Model tasks.

Closes #62.

@google-cla

google-cla Bot commented Jun 5, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces SKILL.md, which defines the SAM Agent Skill for interacting with a local sam-node MCP server, covering connection, mesh inspection, discovery, and safety guidelines. The review feedback suggests simplifying the instructions around namespaced tools returned by find_remote_tools to clarify that all returned tools are namespaced and must be described before calling.

Comment thread SKILL.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create sam SKILL so agents can know how to use it

1 participant