Skip to content

feat: add installable agent skill for code-mode sandbox workflows (#45) - #46

Merged
bwebs merged 2 commits into
mainfrom
bryan/codemode-agent-skill
Aug 28, 2026
Merged

feat: add installable agent skill for code-mode sandbox workflows (#45)#46
bwebs merged 2 commits into
mainfrom
bryan/codemode-agent-skill

Conversation

@bwebs

@bwebs bwebs commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds an installable agent skill (lkr-code-mode) compatible with npx skills and .agents/skills/ conventions, teaching AI agents how to work with the Looker code-mode sandbox non-interactively.

Closes #45

Key Additions

  1. Skill Definition (skills/lkr-code-mode/SKILL.md):
    • Focuses strictly on lkr code-mode sandbox execution (--code, --file, --var, --dev-mode).
    • Documents authentication options (--oauth-account, --force-oauth, --env-file, standard env vars).
    • Documents CLI discovery commands (lkr-dev-cli auth --help, lkr-dev-cli code-mode --help, lkr-dev-cli code-mode sandbox --help).
    • SDK discovery builtins (dir(), help(), lookup(), lookup_type(), search_with_lookups(), examples(), readme()).
    • Common SDK recipes and agent non-interactive execution guidelines.
  2. Bundled Helper Scripts (skills/lkr-code-mode/scripts/):
    • personal_folder_dashboards.py: Inspect user, extract personal_folder_id, retrieve personal dashboards.
    • order_items_query.py: Run inline explore query on thelook / order_items with status filter.
    • traverse_folders.py: Recursively gather dashboards and looks from all nested subfolders.
    • readme.py & examples.py: In-sandbox discovery docs and recipes.
  3. Symlink Structure:
    • .agents/skills/lkr-code-mode symlinked directly to ../../skills/lkr-code-mode.
  4. Docs & Builtins Updates:
    • Top-level README.md updated with npx skills add lkrdev/cli --skill lkr-code-mode install instructions.
    • Updated lkr/codemode/readme.py and lkr/codemode/examples.py with personal folder and inline query examples.

Verification

  • uv run ruff check . passed.
  • uv run pytest tests/test_codemode.py passed (24/24).

@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 the lkr-code-mode agent skill, adding documentation, examples, and helper scripts to enable AI agents to execute Python code and Looker SDK operations non-interactively. The feedback suggests replacing absolute local file URLs in the documentation with relative paths, and adding defensive checks to the helper scripts to handle potential None values gracefully and prevent runtime exceptions.

Comment thread skills/lkr-code-mode/SKILL.md Outdated
Comment thread skills/lkr-code-mode/scripts/personal_folder_dashboards.py Outdated
Comment thread skills/lkr-code-mode/scripts/traverse_folders.py Outdated
@bwebs
bwebs merged commit 427b903 into main Aug 28, 2026
1 check passed
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.

Add installable agent skill for codemode sandbox workflows

1 participant