Agent skills description only makes sense for those who created the description

Open Beginner friendly
#26,010 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
68/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
docker
Domain
documentation

Research direction

Find the Markdown source for /ai/sandboxes/workflows/agent-skills/ and read the quoted paragraph with its surrounding section. Clarify what shared agent skills are and how host agents and sandboxes relate, then verify the page explains this plainly without changing the documented behavior.

Written by the indexing model from the issue text.

Description

status/triage
Is this a docs issue?
  • My issue is about the documentation content or website
Type of issue

Other

Description

Shared agent skills make skills from supported agents on your host available inside your sandboxes. Importing copies the skills into a persistent store that survives sandbox deletion and is shared by default with new sandboxes that run a supported agent.

this only makes sense to the person who wrote it.

What do you want to say?

Shared agent skills transform agents from your host into skills usable inside your sandboxes?

Or do they make skills of agents, but only from agents on your host that are also available inside your sandboxes?

You guys need a technical writer

Location

https://docs.docker.com/ai/sandboxes/workflows/agent-skills/

Suggestion

Hire someone who speaks to humans

Dominant language
Markdown
Stars
4.7k
Forks
8.5k
Avg merge
2d 12h
Merged PRs (30d)
104

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from docker/docs

All issues in docker/docs

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.