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:
- Browse the top‑level README for the skills catalog overview
- Navigate to the relevant product subdirectory (e.g.,
skills/cloud/for Google Cloud skills) - 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 |
Navigate Without Local Clone
You can access help entirely through GitHub's web interface:
- Visit
https://github.com/google/skills - Browse to
skills/[product]/[skill-name]/ - Open
SKILL.mdfor overview - Explore
references/for implementation details - 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.mdin 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.mdguidelines 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:
curl -s "https://instagit.com/install.md" Maintain an open-source project? Get it listed too →