diff --git a/docs/plugins/using-toolkits.md b/docs/plugins/using-toolkits.md
index 189e0b7c..042cfa5b 100644
--- a/docs/plugins/using-toolkits.md
+++ b/docs/plugins/using-toolkits.md
@@ -1,41 +1,130 @@
 # Using Toolkits
+[Toolkits](https://block.github.io/goose/plugins/plugins.html) in Goose are add-ons that expand its capabilities, offering tools and prompts for specific tasks. They make it easier to interact with external systems and handle complex operations. In this guide, we'll cover how to use Toolkits included in `goose` and those available through the `goose-plugins` repository.
 
-Use `goose toolkit list` to list the available toolkits.
+!!! important
+    Before using Toolkits, ensure Goose is installed and properly set up. If you haven’t installed Goose yet, follow the [Goose Installation Guide](https://block.github.io/goose/installation.html).    
 
-## Toolkits defined in Goose
+## Listing Available Toolkits
 
-Using Goose with toolkits is simple. You can add toolkits to your profile in the `profiles.yaml` file. Here's an example of how to add `my-toolkit` toolkit to your profile:
+To list available Toolkits, use the following command within the Goose repo:
+
+```
+goose toolkit list
+```
+
+This will display a list of all Toolkits available in your environment.
+
+The output should look similar to the following: 
+
+```yaml
+Available toolkits:
+ - browser: A toolkit for interacting with web browsers using Selenium.
+ - github: Provides an additional prompt on how to interact with Github
+ - jira: Provides an additional prompt on how to interact with Jira
+ - reasoner: Deep thinking toolkit for reasoning through problems and solutions
+ - repo_context: Provides context about the current repository
+ - screen: Provides an instructions on when and how to work with screenshots
+ - synopsis: Provides shell and file operation tools using OperatingSystem.
+ - codesearch: Provides a way of searching through internal company code.
+ - glean: Provides Goose with access to Glean, our AI search vendor.
+ - java: Provides guidance on how to work in Java codebases
+ - migrate-prefect: Enabled Goose to automate the Prefect 2 migration
+```
+
+The list above is limited. For a complete list, refer to the [Goose Available Toolkits Guide](https://block.github.io/goose/plugins/available-toolkits.html).
+
+## Adding Toolkits to a Profile
+
+To use a Toolkit within your Goose sessions, you'll need to add them to the `profiles.yaml` file, which can be found in your `User` directory at `~/.config/goose/profiles.yaml`. Here's how to add multiple Toolkits:
 
 ```yaml
 my-profile:
   provider: openai
   processor: gpt-4o
   accelerator: gpt-4o-mini
-  moderator: passive
+  moderator: synopsis
   toolkits:
-    - my-toolkit
+    - name: synopsis
+      requires: {}
+    - name: my_toolkit
+      requires: {}
 ```
 
-Then run Goose with the specified profile:
+!!! important
+    You always want to have the `synopsis` Toolkit, formerly known as the `developer` Toolkit enabled. It is essential for Goose to be able to create files for you, if this is removed it will greatly limit Goose's functionality. 
 
-```sh
+
+Additionally, use the `requires` field to specify dependencies between Toolkits, and any necessary configurations. If there are no requirements, simply add an empty set of braces: `{}`. However, if a toolkit requires dependencies or configurations, you can specify that here. For example, if `my_toolkit` depends on `another_toolkit`, you would configure it as shown below:
+
+```yaml
+my-profile:                                                                                                                       
+  provider: openai                                                                                                                
+  processor: gpt-4o                                                                                                               
+  accelerator: gpt-4o-mini                                                                                                        
+  moderator: synopsis                                                                                                              
+  toolkits:                                                                                                                       
+    - name: synopsis                                                                                                             
+      requires: {}                                                                                                                
+    - name: my_toolkit                                                                                                            
+      requires:                                                                                                                   
+        another_toolkit:                                                                                                          
+          config_option_1: value1  
+```
+
+## Starting a Goose Session with Toolkits
+
+Once your [profile](https://block.github.io/goose/guidance/getting-started.html#configuring-goose-with-the-profilesyaml-file) is set up, start a Goose session with the specified profile:
+
+```bash
+goose session start --profile my-profile
+```
+This command initializes Goose with the Toolkits defined in your profile.
+
+!!! example
+    If your profile includes the `synopsis` and `my_toolkit` Toolkits, Goose will initialize with both functionalities.
+
+## Using Toolkits from Goose Plugins
+
+To access additional Toolkits provided by the `goose-plugins` repository, follow these steps:
+
+### Install `goose-plugins`:
+
+Run the following command to install the `goose-plugins` package:
+
+```bash
+ pipx install goose-ai --preinstall goose-plugins
+```
+
+### List available toolkits:
+
+Within the `goose-plugins` repo, you may need to [install `uv`](https://docs.astral.sh/uv/getting-started/installation/) first. 
+
+```bash
+uv run goose toolkit list
+```
+
+### Update the `profiles.yaml` File:
+Add the desired Toolkit from the `goose-plugins` repository to your profile. For example:
+
+```yaml
+my-profile:
+  provider: openai
+  processor: gpt-4o
+  accelerator: gpt-4o-mini
+  moderator: synopsis
+  toolkits:
+    - name: synopsis                                                                                                             
+      requires: {}   
+    - name: artify
+      requires: {}
+```
+
+### Start the Goose Session:
+
+```bash
 goose session start --profile my-profile
 ```
 
-## Toolkits defined in Goose Plugins
 
-1. First make sure that `goose-plugins` is intalled with Goose:
-```sh
-pipx install goose-ai --preinstall goose-plugins
-```
-2. Update the `profiles.yaml` file to include the desired toolkit:
-```yaml
-my-profile:
-  provider: openai
-  processor: gpt-4o
-  accelerator: gpt-4o-mini
-  moderator: passive
-  toolkits:
-    - my-goose-plugins-toolkit
-```
+