| name | create-usercontext-instructions |
| description | Create complete user-context instruction files using a structured discovery workflow and repository format rules. |
| version | 1.0.0 |
| allowed-tools | ["Read","Write","Edit"] |
| metadata | {"source_prompt":"prompts/skills/create-usercontext-instructions.prompt.md","workflow_type":"generation"} |
Create User Context Instructions
Purpose
Generate a complete user-context instruction file with required sections, privacy-aware content handling, and consistent output formatting.
When To Use
- Use this skill when the task is to create or regenerate a
*_usercontext.instructions.md file.
- Use this skill when user context must be gathered through structured phases.
- Do not use this skill for project
AGENTS.md (project context) files.
How to Invoke
Load or attach this file's contents into your AI session to activate the workflow (paste, upload, or reference with #file:skills/create-usercontext-instructions/SKILL.md in VS Code Copilot Chat). In Claude Projects, add it to project knowledge. See Invoking Skills in the README for full platform guidance.
Required Inputs
- Target identity label and role/title.
- Privacy expectations (full detail vs placeholders).
- Technical profile, projects, goals, style, and constraints.
- Desired output filename/path.
Workflow
- Run phased discovery using
references/discovery-phases.md.
- Normalize findings into required schema using
references/output-schema.md.
- Apply format contract from
references/output-format.md.
- Stamp
spec_version: "1.4.3" in the YAML frontmatter of the generated artifact.
- Validate against
references/quality-checklist.md before final output.
- If structured metadata is requested, apply
references/json-metadata-schema.md.
Output Expectations
- One complete
*.instructions.md file for user context.
- Required section coverage and logical ordering are preserved.
- Privacy handling is explicit and consistent.
- Output is provider-neutral.
- Output contract and summary format follow
references/output-format.md.
Resources
- Discovery workflow:
references/discovery-phases.md
- Output schema:
references/output-schema.md
- Optional metadata schema:
references/json-metadata-schema.md
- Output contract:
references/output-format.md
- Quality checklist:
references/quality-checklist.md
- Structure baseline:
../../templates/usercontext_template.instructions.md
- Example reference:
../../usercontexts/sample_usercontext.instructions.md
Constraints And Safety
- Keep provider-neutral wording.
- Preserve sensitive data boundaries; prefer placeholders when requested.
- Use relative paths for references.
- Avoid unrelated recommendations outside user-context scope.
