How to Get Help with a Specific Skill Implementation in google/skills

To get help with a specific skill implementation in google/skills, navigate to the skill's dedicated directory, consult its SKILL.md file for core documentation, review the references/ sub‑folder for language‑specific examples, and use GitHub issues or discussions if you need additional support.

The google/skills repository is a structured collection of self‑contained skill implementations covering Google Cloud capabilities and other Google technologies. Each skill directory contains everything necessary to learn, run, and extend that capability—making help discovery a matter of following the repository's built‑in navigation system rather than searching external documentation.

Locate the Skill Directory

Skills in the repository are organized hierarchically under the skills/ folder, grouped by product area. To find your target skill:

  1. Browse the top‑level README for the skills catalog overview
  2. Navigate to the relevant product subdirectory (e.g., skills/cloud/ for Google Cloud skills)
  3. Open the specific skill folder (e.g., spanner-basics/)

Example Navigation


# Clone the repository

git clone https://github.com/google/skills.git
cd skills

# List available cloud skills

ls skills/cloud/

# Navigate to a specific skill

cd skills/cloud/spanner-basics

Read the SKILL.md File

Every skill contains a SKILL.md file at its root—this is the authoritative source for that skill's implementation details. According to the google/skills source code structure, this file provides:

  • Purpose statement – what the skill demonstrates
  • Prerequisites – required accounts, permissions, and tools
  • Step‑by‑step walkthroughs – guided implementation paths
  • Links to deeper reference material – cross‑references within the repository

# View the skill definition locally

less skills/cloud/spanner-basics/SKILL.md

# Or view directly on GitHub

open https://github.com/google/skills/blob/main/skills/cloud/spanner-basics/SKILL.md

Consult the references/ Sub‑Folder

For implementation‑level help, each skill includes a references/ directory containing specialized documentation:

Reference File Content Type
client-library-usage.md Language‑specific code samples (Python, Go, Java, Node.js, etc.)
terraform.md Infrastructure-as‑code configurations
iam.md Identity and access management guidance
cli.md gcloud command references

These files contain runnable code snippets you can adapt directly:


# Browse reference documentation

ls skills/cloud/spanner-basics/references/

# View client library examples

less skills/cloud/spanner-basics/references/client-library-usage.md

Running Example Code


# Example: Execute Python snippet from reference documentation

python3 - <<'PY'
from google.cloud import spanner

# ... (sample code adapted from references/client-library-usage.md)

PY

Use Repository Contribution Channels

When documentation does not resolve your question, google/skills provides structured support pathways:

Open a GitHub Issue

The repository includes issue templates. Always specify the skill path so maintainers can locate relevant files quickly.


# Access the issue template

open https://github.com/google/skills/blob/main/.github/ISSUE_TEMPLATE.md

Start a GitHub Discussion

Use Discussions for questions that don't require code changes—implementation clarifications, best practice inquiries, or architecture guidance.

Key Support Files

File Purpose Direct Link
CONTRIBUTING.md How to report problems, request features, ask clarifications CONTRIBUTING.md
README.md Project overview and skills catalog entry point README.md
.github/ISSUE_TEMPLATE.md Pre‑filled template for structured problem reports ISSUE_TEMPLATE.md

You can access help entirely through GitHub's web interface:

  1. Visit https://github.com/google/skills
  2. Browse to skills/[product]/[skill-name]/
  3. Open SKILL.md for overview
  4. Explore references/ for implementation details
  5. Click Issues → New Issue if you need assistance

Summary

  • Skill location: Navigate skills/[product]/[skill-name]/ following the hierarchical directory structure
  • Primary documentation: Read SKILL.md in the skill root for purpose, prerequisites, and walkthroughs
  • Implementation details: Check references/ sub‑folder for language‑specific code, Terraform, IAM, and CLI guidance
  • Escalation path: Use CONTRIBUTING.md guidelines to open issues or discussions, always including the skill path

Frequently Asked Questions

What is the fastest way to find documentation for a specific skill?

Navigate directly to skills/[product]/[skill-name]/SKILL.md in the repository. This single file contains the complete overview, prerequisites, and guided steps for that skill. For Cloud Spanner basics, the direct URL is https://github.com/google/skills/blob/main/skills/cloud/spanner-basics/SKILL.md.

Where are code examples stored in the google/skills repository?

Code examples reside in the references/ sub‑folder within each skill directory. Look for client-library-usage.md for Python, Go, Java, and Node.js samples; terraform.md for infrastructure configurations; and cli.md for gcloud commands.

How do I report a problem with a specific skill implementation?

Open a GitHub issue using the template at .github/ISSUE_TEMPLATE.md, and include the full skill path (e.g., skills/cloud/spanner-basics) in your report. The CONTRIBUTING.md file provides complete guidelines for submitting issues, requesting features, and asking clarification questions.

Can I get help without cloning the google/skills repository?

Yes. All documentation is browsable on GitHub's web interface. Navigate to the skill directory, read SKILL.md, explore references/ files, and open issues directly from the repository website without any local setup.

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →