docs(plugin): polish workspace-load skill guidance after #692 - #698
Merged
Conversation
- SKILL.md triggers: zero-copy clone, workspace load type, table too big to load, load table into workspace cheaply - workspace-workflow: cheapest-first ordering (skip load > clone > view > copy), verify-via-tables[] note, and fix a misleading example -- the size guard only fires for resolved COPY, so --force on an explicit clone is a no-op; --json mode never prompts (--force up front) - typify-table / storage-types workflows: warn that a large typeless table COPY needs --force in non-interactive mode - keboola-expert: STORAGE_JOB_TIMEOUT is now exit 4 (retryable) and the job keeps running server-side
…sktop limit test_skill_frontmatter caps the frontmatter description at 1024 chars (issue #447); the new workspace-load triggers pushed it to 1088. Keep the two strongest new triggers (zero-copy clone, workspace load type) and drop the descriptive '(backup/restore)' parenthetical.
padak
force-pushed
the
docs/kbagent-skill-workspace-load-polish
branch
from
August 25, 2026 13:28
58d0749 to
735d5bf
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs-only follow-up to #692 (plugin ships via git, no release needed). Improvements beyond the mandatory sync:
tables[].load_typereport, and a correction of a misleading example shipped in feat(workspace): zero-copy CLONE by default, large-COPY guard, fire-and-forget timeout fix #692: the size guard only fires for a resolved COPY, so--forceon an explicit--load-type cloneis a no-op (and clone never needs a longer--timeout). Replaced with two accurate examples and clarified that--jsonmode never prompts ----forcemust be passed up front.--forcerequirement.STORAGE_JOB_TIMEOUTis now exit 4 (retryable) and the job keeps running server-side. 52,086 B of the 70,000 B budget.Rejected (checked, no change needed): gotchas.md #692 entry already matches the file's best entries; the 60 s
STORAGE_JOB_MAX_WAITclaim in gotchas.md is still literally true (workspace load uses its own constant); semantic-layer/stream workflows load small targeted tables; sql-migration-workflow does not callworkspace loadat all.Checks:
make skill-checkOK,check_command_sync.pyOK (267 commands),test_agent_prompt.py42 passed.