> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Write Skill File • AI Agent SDK

> write_skill_file: Write a file within a skill's directory.

# write\_skill\_file

<div className="flex items-center gap-2">
  <Badge color="purple">Method</Badge>
</div>

> This is a method of the [**SkillManager**](../classes/SkillManager) class in the [**manager**](../modules/manager) module.

Write a file within a skill's directory.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
def write_skill_file(name: str, file_path: str, file_content: str, propose: Optional[bool]) -> dict
```

## Parameters

<ParamField query="name" type="str" required={true}>
  Skill name
</ParamField>

<ParamField query="file_path" type="str" required={true}>
  Relative path within skill (must be under allowed subdirs)
</ParamField>

<ParamField query="file_content" type="str" required={true}>
  File content to write
</ParamField>

<ParamField query="propose" type="Optional[bool]" required={false}>
  If True, stage the write for human approval instead of writing to disk. Defaults to the manager's `write_approval` policy. Pass `propose=False` to write directly.
</ParamField>

### Returns

<ResponseField name="Returns" type="dict">
  Dict with success status
</ResponseField>

## Uses

* `get_skill`
* `Path`
* `relative_path.is_absolute`
* `resolve`
* `target_file.relative_to`
* `mkdir`

## Used By

* [`SkillManager.write_file`](../functions/SkillManager-write_file)

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/skills/manager.py#L1051">
  `praisonaiagents/skills/manager.py` at line 1051
</Card>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Skills Concept" icon="wand-magic-sparkles" href="/docs/docs/concepts/skills" />

  <Card title="Skills Feature" icon="star" href="/docs/docs/features/skills" />
</CardGroup>