docs: add linear and code-plan to embedded-skills index#72
Merged
Conversation
Mirrors the SKILL.md contracts merged via PR #67 (linear) and PR #69 (code-plan) into the user-facing docs at docs/skills/embedded-skills.md. - Summary table gets two new rows in the developer/project-management cluster, with full script lists for each. - New "Linear Skill" section covering the six tools, the get_workflow_states → update_issue_state hard rule, the one-comment-per-action etiquette, the no-Bearer-prefix auth gotcha that bit us in PR #67 follow-up, and the ticket-driven workflow cross-reference into code_plan_create and github. - New "Code Plan Skill" section covering the two tools (LLM-call vs filesystem audit), repo-signal sampling at 256 KB, the repo_too_large escape, the plan-then-execute contract that downstream code-writing tool calls must match, and the schema-validation retry. No code or SKILL.md changes — pure docs sync. README is unchanged (it only links to docs/skills/writing-custom-skills.md, not to this file directly, so no top-level index update is needed). PR #71's github-skill ticket-driven update will be doc-synced separately into the same file via that PR's branch.
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.
Summary
Doc sync follow-up for the two skill PRs that already merged:
These shipped without updating the user-facing index at `docs/skills/embedded-skills.md` (the `/sync-docs` plugin mapping does not cover `forge-skills/...` yet). This PR closes that gap so the docs match what's in
main.Changes
docs/skills/embedded-skills.md:linear📋 project-management — six scripts listedcode-plan🗺️ developer — two scripts listedget_workflow_statesbeforeupdate_issue_state" hard ruleBearerprefix auth gotcha that surfaced during PR feat(skills): add linear embedded skill (closes #66) #67 live testingcode_plan_create(one LLM call) vscode_plan_validate(filesystem audit, no LLM)repo_too_largeescape behaviourANTHROPIC_API_KEY/OPENAI_API_KEYone_ofprovider selection,PLAN_MODELoverrideTest plan
.github/workflows/docs-links.yaml) passes — 37 files checked, no broken relative links#code-plan-skill,#github-skill) resolveOut of scope
Why a separate PR
PR #67 and PR #69 are already merged. The `/sync-docs` plugin's mapping table doesn't include `forge-skills/...`, so the docs missed the train. This PR is the smallest possible fix — pure docs, no code.