1
0
mirror of https://github.com/docker/docs.git synced 2026-10-23 18:09:02 +03:00
Commit Graph

19 Commits

Author SHA1 Message Date
David Karlsson
b16b881db7 ci: remove automated what's new workflow
The scheduled curation workflow adds operational complexity to an editorial task that requires human review.
Remove the automation and tune the retained skill to report decisions directly without workflow-specific handoff files.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-24 12:29:43 +00:00
David Karlsson
ccb8e85e45 ci: make what's new updates incremental (#25817)
## Summary

Fix the Sonnet 5 request failure by removing the deprecated temperature
setting. Make daily curation incremental: skip the model when there are
no unseen merges or expired highlights, review only unseen merge dates
when work exists, and retain a manual full-window recalibration option.

Generated by Codex
2026-08-14 16:52:55 +02:00
David Karlsson
678542f456 docs: add automated what's new highlights (#25729)
## Summary

Replace the static Featured topics section with a data-driven Whatʼs new
timeline. Show the five most important launches by default and let
readers expand the full curated 30-day archive.

Run a daily Claude Sonnet 5 curator over a rolling 30-day window, with
manual dispatch support, deterministic validation, and bot-managed pull
requests. Package the editorial workflow as the reusable
`curate-whats-new` repository skill so Docker Agent and other Agent
Skills-compatible clients can invoke the same process.

Preserve the human-reviewed July 13 through August 11, 2026 result and
flexible selection criteria as a regression example outside the skillʼs
runtime context.

@netlify /

[Homepage
preview](https://deploy-preview-25729--docsdocker.netlify.app/)

Generated by Codex
2026-08-12 17:23:31 +02:00
David Karlsson
e4fb7bd67c docs: add PR review and maintenance skills 2026-08-11 10:17:35 +00:00
David Karlsson
63ddb2912c Merge pull request #25710 from dvdksn/codex/migrate-rumdl
build: migrate Markdown tooling to rumdl
2026-08-05 09:16:24 +02:00
David Karlsson
1566bcf8f5 docs: prune learnings section and tighten create-pr skill (#25453)
## Summary

Removes the unused Learnings/reflections section from the create-pr
skill (the self-learning loop it fed was never used), adds optional
guidance for Netlify deploy-preview entry paths and deep links on
focused PRs, and tightens the branch/remote handling (default-branch
guard, `git status --porcelain` clean-tree check, origin-vs-fork
fallback, and a `docs:` title-prefix note).

Generated by Claude Code

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-20 14:02:14 +02:00
Stefano Baghino
b162a7a83a agents: scope git hygiene hook to git add commands
The `PreToolUse:Bash` hook invoked `enforce-git-hygiene.sh` on every Bash tool call, even though the script only blocks `git add . / -A / --all`. Add `"if": "Bash(git add *)"` so the script only runs when the command actually contains `git add`.
2026-05-21 10:29:54 +02:00
David Karlsson
f0f393aba5 Merge pull request #25103 from dvdksn/worktree-update-create-pr-skill
create-pr skill: prohibit Test plan section
2026-05-19 21:03:18 +02:00
David Karlsson
3d30a927e3 create-pr skill: prohibit Test plan section
Documentation PRs don't need test plans, but the system-level PR
template includes one. Add an explicit prohibition so the skill
instruction overrides the default.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-19 17:10:52 +02:00
David Karlsson
8571e1b322 agents: hoist lint.sh to scripts/ for cross-skill use
The lint script was buried in the write skill's scripts directory, so
only agents that invoked that specific skill discovered it. Move it to
the repo-level scripts/ directory and reference it from AGENTS.md so
every agent session sees the recommended workflow.

- scripts/lint.sh: scoped markdownlint + vale on changed files
- AGENTS.md Commands and Verification loop now point here
- write skill SKILL.md updated to use the new path
- post-edit.sh stays in the skill (it's a PostToolUse hook tied to that
  skill's lifecycle)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-12 12:40:03 +02:00
Yogesh Rao
1203a74690 feat: improve create-lab-guide skill score 69% → 90%
Hey @dvdksn 👋

I ran your skills through `tessl skill review` at work and found some targeted improvements for `create-lab-guide`. Here's the full before/after:

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| create-lab-guide | 69% | 90% | +21% |
| check-pr | 99% | — | — |
| fix-issue | 99% | — | — |
| research | 97% | — | — |
| triage-issue | 96% | — | — |
| write | 93% | — | — |
| agent-readiness-audit | 93% | — | — |
| testcontainers-guides-migrator | 90% | — | — |
| create-pr | 90% | — | — |
| review-changes | 86% | — | — |
| migrate-content-ia | 79% | — | — |

## Description

Improves the `create-lab-guide` skill's description and content structure. The skill had the lowest baseline score (69%) across the repo's 11 skills, with the most room to grow — so it made sense to focus here.

<details>
<summary>Changes made</summary>

- **Rewrote frontmatter description** with explicit "Use when..." clause and five natural trigger terms (`create a lab guide`, `write a Labspace page`, `add a Docker lab tutorial`, `migrate a lab to docs`, `document a hands-on lab`)
- **Fixed duplicate "Step 2" heading** — renumbered to a proper 5-step sequence (Clone → Extract → Write → Style → Validate)
- **Added validation step (Step 5)** with explicit gate: frontmatter field checks, prettier formatting, lint/vale pass, and manual review before commit
- **Compressed style rules** from a verbose bullet list into a scannable two-column table
- **Replaced prose file listing** with a structured table mapping files to their purpose
- **Preserved all Labspace domain expertise**: `labspace.yaml`, `labspace-launch` shortcode, `dockersamples` org conventions, `model-download` parameter, `compose.override.yaml` model detection

</details>

I also stress-tested your `triage-issue` skill against a few real-world task evals and it held up really well on issue verdict decision trees with cross-referenced timeline checks. Kudos for that.

Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch — just saw room for improvement and wanted to contribute.

Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at [this Tessl guide](https://docs.tessl.io/evaluate/optimize-a-skill-using-best-practices) and ask it to optimize your skill. Ping me — [@yogesh-tessl](https://github.com/yogesh-tessl) — if you hit any snags.

## Related issues or tickets

N/A — proactive improvement based on skill evaluation.

## Reviews

- [ ] Technical review
- [ ] Editorial review

Thanks in advance 🙏
2026-05-08 22:49:36 +05:30
Codex
a1d393f989 docs: prevent duplicate issue fix PRs
The issue triage and PR creation workflows did not require checking issue timeline cross-references for existing open PRs.

Added timeline checks to triage and create-pr instructions so agents skip duplicate PRs when an issue already has an associated fix.

Co-Authored-By: Codex <noreply@openai.com>

oreply@openai.com>
2026-05-06 09:31:10 +02:00
David Karlsson
dd258fc2db Merge pull request #24887 from dvdksn/docs/skill-agent-disclosure-footer
docs: fix skill agent disclosure guidance
2026-04-27 18:24:05 +02:00
Alexa Kristensen
26ea39ec33 Agent redirect skill and small admin > company reorg (#24856)
This PR captures a small chunk of work intended to test a new agent
skill for handling redirect aliases, link references, and link anchors.
2026-04-24 07:50:35 -05:00
David Karlsson
2af0644328 feat: add agent readiness audit skill 2026-04-24 12:12:36 +02:00
David Karlsson
3bb23342fa docs: fix skill agent disclosure guidance
Several repo-managed skills hardcoded Claude Code in PR and issue comment footers.\n\nUpdate the skill guidance to require naming the active coding agent explicitly instead of hardcoding a specific tool name.
2026-04-24 10:01:55 +02:00
Michael Irwin
346829436f Add new skill to create a guide for a labspace 2026-04-02 14:41:46 -04:00
David Karlsson
04f9e20d53 Merge pull request #24591 from dvdksn/sbx-follow-up-fixes
sandboxes: follow-up fixes and clarifications from sbx docs rewrite
2026-03-31 19:01:13 +02:00
David Karlsson
2c4facb6d0 feat: rewrite skills/agent docs
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-03-31 15:20:07 +02:00