Best guidance for tools writting

[isidorn]

We should be inspired by Claude tool docs https://docs.anthropic.com/en/docs/build-with-claude/tool-use/overview#best-practices-for-tool-definitions and provide similar best practices.