Index of every page on this site: llms.txt
All skills
googleworkspace avatar

/gws-keep

@cd3697e
by Google Workspacegoogleworkspace/cli32k stars
1,997
Run it yourself

Manage Google Keep notes.

Use this Skill: https://skilld.dev/gh/googleworkspace/cli/gws-keep

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈9 tokens for metadata: the name and description. ≈391 when used: this file.

How this Skill uses context

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈36 characters, or 0.4%.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

keep (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws keep <resource> <method> [flags]

API Resources

media

  • download — Gets an attachment. To download attachment media via REST requires the alt=media query parameter. Returns a 400 bad request error if attachment media is not available in the requested MIME type.

notes

  • create — Creates a new note.
  • delete — Deletes a note. Caller must have the OWNER role on the note to delete. Deleting a note removes the resource immediately and cannot be undone. Any collaborators will lose access to the note.
  • get — Gets a note.
  • list — Lists notes. Every list call returns a page of results with page_size as the upper bound of returned items. A page_size of zero allows the server to choose the upper bound. The ListNotesResponse contains at most page_size entries. If there are more things left to list, it provides a next_page_token value. (Page tokens are opaque values.) To get the next page of results, copy the result's next_page_token into the next request's page_token.
  • permissions — Operations on the 'permissions' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws keep --help

# Inspect a method's required params, types, and defaults
gws schema keep.<resource>.<method>

Use gws schema output to build your --params and --json flags.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill allows the agent to manage Google Keep notes and media. It interacts with the Google Workspace Keep API, which involves processing user-controlled note content.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at cd3697e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 8 months ago
Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws keep --help"
  }
}
  • CLI
  • google-keep
  • google-workspace
  • notes
  • gws
  • productivity

README badge

README badge for googleworkspace/cli/gws-keep

Manages Google Keep notes via CLI commands for create, read, list, delete, and permission operations. Requires the gws CLI tool and Google Workspace authentication configured through the shared gws-shared skill.

Generated from the current SKILL.md.

What authentication does this skill require?
This skill requires the gws CLI tool with Google Workspace authentication configured. See the gws-shared SKILL.md for auth setup and security rules.
Can I create, read, and delete notes with this skill?
Yes. The skill supports creating notes, listing and retrieving individual notes, and deleting notes (if you have OWNER role). It also handles note permissions and media attachments.
How do I discover available parameters for a command?
Use `gws schema keep.<resource>.<method>` to inspect a method's required parameters, types, and defaults before building your API call.
Does this skill support pagination for listing notes?
Yes. The list method returns paginated results with a `next_page_token` field; pass that token in subsequent requests to fetch additional pages.

Generated from the current SKILL.md. These answers refresh after source changes.