Feature/add skills

[atripathy86]

Related Issues / Pull Requests

List all related issues and/or pull requests if there are any.

Description

Add /cmf skills support for coding agents.
Adds a skills/ directory with six skills installable via
npx skills add HewlettPackard/cmf --full-depth -y, compatible
with Claude Code, GitHub Copilot, Cursor, Codex, OpenCode, and
any agentskills.io-compatible coding assistant.

What changes are proposed in this pull request?

• Bug fix (non-breaking change which fixes an issue).
• New feature (non-breaking change which adds functionality).
• Breaking change (fix or feature that would cause existing functionality to not work as expected; for instance,
  examples in this repository need to be updated too).
• This change requires a documentation update.

Checklist:

• My code follows the style guidelines of this project (PEP-8 with Google-style docstrings).
• My code modifies existing public API, or introduces new public API, and I updated or wrote docstrings that
  uses Google-style formatting and any other formatting that is supported by mkdocs and plugins this project
  uses.
• I have commented my code.
• My code requires documentation updates, and I have made corresponding changes to the documentation
• I have added tests that prove my fix is effective or that my feature works.
• New and existing unit tests pass locally with my changes.

[Copilot]

Pull request overview

This PR adds “agent skills” (agentskills.io-compatible prompt files) to the CMF repo and publishes documentation so coding assistants can guide users through common CMF workflows (init, instrumentation, sync, query, server, MCP).

Changes:

• Added a skills/ directory with multiple CMF skills (/cmf, /cmf-init, /cmf-instrument, /cmf-sync, /cmf-query, /cmf-server, /cmf-mcp) plus reference/source docs.
• Added a MkDocs documentation page (docs/skills/index.md) and wired it into mkdocs.yaml.
• Added Claude marketplace metadata under .claude-plugin/.

Reviewed changes

Copilot reviewed 24 out of 24 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
skills/README.md	Skills installation/usage documentation for multiple agents
skills/cmf/SKILL.md	Router skill that maps user intent to the right sub-skill
skills/cmf-init/SKILL.md	Initialization workflow skill (env setup + cmf init)
skills/cmf-init/sources.md	Source links for cmf-init skill content
skills/cmf-init/references/init-commands.md	Reference table for cmf init subcommands and flags
skills/cmf-instrument/SKILL.md	Skill instructions/templates for instrumenting Python ML code with CMF
skills/cmf-instrument/sources.md	Source links for cmf-instrument skill content
skills/cmf-instrument/references/api-reference.md	cmflib API reference table used by the skill
skills/cmf-sync/SKILL.md	Skill for push/pull of metadata and artifacts and team workflows
skills/cmf-sync/sources.md	Source links for cmf-sync skill content
skills/cmf-sync/references/cli-commands.md	CLI reference table for sync commands
skills/cmf-query/SKILL.md	Skill for writing CmfQuery/CLI queries for lineage and metadata
skills/cmf-query/sources.md	Source links for cmf-query skill content
skills/cmf-query/references/query-api.md	Reference table of CmfQuery methods
skills/cmf-server/SKILL.md	Skill for deploying/connecting to CMF Server via Docker Compose
skills/cmf-server/sources.md	Source links for cmf-server skill content
skills/cmf-server/references/env-variables.md	Reference for server .env variables (including MCP vars)
skills/cmf-mcp/SKILL.md	Skill for deploying/configuring MCP server and connecting agents
skills/cmf-mcp/sources.md	Source links for cmf-mcp skill content
skills/cmf-mcp/references/mcp-tools.md	MCP tools list and environment configuration snippet
docs/skills/index.md	MkDocs page documenting installation and available skills
mkdocs.yaml	Adds “Agent Skills” to the documentation navigation
.claude-plugin/plugin.json	Claude plugin metadata for the skills bundle
.claude-plugin/marketplace.json	Claude marketplace manifest for publishing the plugin

Comments suppressed due to low confidence (3)

skills/cmf-mcp/SKILL.md:31

• Environment variable names here don’t match the actual MCP server configuration. The MCP service (docker-compose-server.yml) and mcp/main.py require CMF_BASE_URL / CMF2_BASE_URL / …, but this skill instructs users to set CMF_SERVER_URL / CMF_SERVER_URL_2. Update the skill to use the real variable names so the MCP server can start and connect to CMF.

Edit `.env`:
```env
CMF_SERVER_URL=http://<your-cmf-server-host>:80
# Optional second/third server:
# CMF_SERVER_URL_2=http://staging-server:80

**skills/cmf-mcp/SKILL.md:36**
* `docker compose up -d` is run from `mcp/`, but there’s no compose file in that directory. Either document starting the MCP server via the root `docker-compose-server.yml` (where the `mcp` service is defined) or add a dedicated compose file under `mcp/` to support these commands.

docker compose up -d
curl http://localhost:8000/health   # → {"status": "ok"}

**skills/cmf-mcp/SKILL.md:58**
* The agent connection examples hardcode `http://localhost:8000/mcp`, but in the standard `docker-compose-server.yml` setup the MCP container listens on 8000 internally and is exposed on the host via `MCP_EXTERNAL_PORT` (default 8382). The documented URL should reflect the actual host port (or explicitly instruct setting `MCP_EXTERNAL_PORT=8000`).

Claude Code — .mcp.json (project root)

{
  "mcpServers": {
    "cmf": { "url": "http://localhost:8000/mcp", "transport": "http" }
  }
}

Restart Claude Code or run /mcp to reload.

GitHub Copilot — VS Code settings

{
  "github.copilot.chat.mcpServers": {
    "cmf": { "url": "http://localhost:8000/mcp", "transport": "http" }
  }
}

Add to .vscode/settings.json or VS Code user settings. Reload the window.

</details>



---

💡 <a href="/HewlettPackard/cmf/new/master?filename=.github/instructions/*.instructions.md" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Add Copilot custom instructions</a> for smarter, more guided reviews. <a href="https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Learn how to get started</a>.