docker / docker/docs

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.

status/triage
Dominant language
Markdown
Stars
4.7k
Forks
8.5k
Avg merge
2d 18h
Merged PRs (30d)
108

Description

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

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.

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.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.