document and further work on skeleton